Skip to content

Commit

Permalink
Update Ora2pg Datastream Tutorial with Up-to-date Requirements and Li…
Browse files Browse the repository at this point in the history
…mitations (GoogleCloudPlatform#1877)

* Update Ora2pg Datastream Tutorial with Up-to-date Requirements and Limitations

* copy edit

Co-authored-by: Thomas Chan <ktchana@google.com>
Co-authored-by: Todd Kopriva <43478937+ToddKopriva@users.noreply.github.com>
  • Loading branch information
3 people authored Jul 19, 2021
1 parent 3c02533 commit ac52a7d
Showing 1 changed file with 6 additions and 12 deletions.
18 changes: 6 additions & 12 deletions tutorials/migrate-oracle-postgres-using-datastream/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,8 @@ Use the [pricing calculator](https://cloud.google.com/products/calculator) to ge
## Source database requirements

For the migration to be successful, you must ensure that several requirements are satisfied on the source Oracle database, to ensure compatibility with the
toolchain used in this tutorial.
toolchain used in this tutorial. For up-to-date information about version requirements, see the
[Datastream documentation](https://cloud.google.com/datastream/docs/sources#versionsfororaclesourcedb).

* **Version**: Oracle 10g v10.2, 11g v11.2.0.4, 12c v12.1.0.2/1, 18c, or 19c

Expand All @@ -71,12 +72,6 @@ toolchain used in this tutorial.

* **Size**:

* Oracle databases up to 10 TB.

You can check the database size with this SQL query:

select sum(bytes)/1024/1024 size_in_mb from dba_segments;

* Tables of up to 100 GB.

This is a soft limit, and Datastream will attempt to perform backfill on any table that you supply. However, we recommend
Expand All @@ -94,7 +89,8 @@ toolchain used in this tutorial.
## Notable behaviors and limitations

This section describes notable behaviors and limitations of the migration process. It is important for you to understand these behaviors and limitations and plan
ahead to avoid running into problems during the migration.
ahead to avoid running into problems during the migration. For up-to-date information about known limitations, see the
[Datastream documentation](https://cloud.google.com/datastream/docs/sources#oracleknownlimitations).

* **Primary key and ROWID**: We recommend that you have a primary key on all tables.

Expand All @@ -109,11 +105,9 @@ ahead to avoid running into problems during the migration.

* **Column support**:

* **Not supported**: Abstract DataTypes (ADT), Collections (VARRAY), LOB, UDT, CACHESYNC_MESSAGE, UROWID, ANYDATA, LONG, LONG RAW, XMLType.

These replicate as null values for their columns.
* Columns of data types ANYDATA, BLOB, CLOB, LONG/LONG RAW, NCLOB, UDT, UROWID, XMLTYPE aren't supported, and will be replaced with NULL values.

* BLOB and CLOB data types are limited to a maximum size of 4 kilobytes.
* For Oracle database 11g, tables that have columns of data types ANYDATA or UDT aren't supported, and the entire table won't be replicated.

* Deferred constraints are converted to non-deferred constraints as part of the standard conversion. This can be customized by setting `FKEY_DEFERRABLE=0` in
the `ora2pg.conf` configuration file.
Expand Down

0 comments on commit ac52a7d

Please sign in to comment.