構文

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CREDENTIAL(
    credential_name VARCHAR2(128) DEFAULT NULL,
    dcat_con_id     VARCHAR2 DEFAULT NULL
  );

パラメータ

使用法

この資格証明には、データ・カタログの管理権限が必要です。データ・カタログ・ポリシーを参照してください。デフォルトはリソース・プリンシパルです。ポリシーおよびロールの構成によるクラウド・リソースへのアクセスを参照してください。

構文

PROCEDURE DBMS_DCAT.SET_OBJECT_STORE_CREDENTIAL(
    credential_name  VARCHAR2(128),
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
  );

パラメータ

構文

PROCEDURE DBMS_DCAT.SET_DATA_CATALOG_CONN (
   region       VARCHAR2 DEFAULT NULL,
   endpoint     VARCHAR2 DEFAULT NULL,
   catalog_id   VARCHAR2 DEFAULT NULL,
   dcat_con_id  VARCHAR2 DEFAULT NULL,
   catalog_type VARCHAR2 DEFAULT NULL
 );

パラメータ

使用法

このプロシージャをコールする必要があるのは、接続を設定するために1回のみです。接続プロセスの一部として、Autonomous Databaseはカスタム・プロパティをデータ・カタログに追加します。これらのカスタム・プロパティには、データ・カタログ・ユーザーがアクセスでき、デフォルト名(スキーマ、表および列の場合)および列データ型をオーバーライドできます。

接続を作成する前に、資格証明を作成して設定する必要があります。接続プロセスの詳細は、OCIデータ・カタログの「データ・カタログを使用した一般的なワークフロー」およびAWS Glueデータ・カタログの「AWS Glueデータ・カタログを使用した問合せのユーザー・ワークフロー」を参照してください。

例: 既知のOCIDとの接続

この例では、Autonomous Databaseはuk-london-1リージョンのデータ・カタログに接続しています。catalog_idパラメータでは、データ・カタログ・インスタンスにOracle Cloud Identifier (ocid)を使用します。データ・カタログのタイプ(AWS Glue Data CatalogまたはOCI Data Catalog)が自動的に決定されます。

例: AWS Glueデータカタログへの接続

接続とは、Autonomous DatabaseインスタンスとAWS Glueデータ・カタログとの間の関連付けです。接続に成功すると、Autonomous DatabaseインスタンスはAWS Glueと同期できます。各AWSアカウントには、リージョンごとに1つのAWS Glue Data Catalogがあり、各カタログには、各リージョンに対応するサービス・エンドポイントを使用してアクセスできます。Autonomous Databaseインスタンスは、API DBMS_DCAT.SET_DATA_CATALOG_CONNを起動し、カタログが存在するリージョンのエンドポイントを指定することで、AWS Glueデータ・カタログに関連付けることができます。

AWS Glueエンドポイントおよび割当て制限を参照してください。

この例では、Autonomous Databaseは、uk-london-1リージョンのAWS Glue Data Catalogに接続しています。これはAWS Glue Data Catalog接続であるため、catalog_idパラメータは必要ありません。

構文

PROCEDURE DBMS_DCAT.UNSET_DATA_CATALOG_CONN (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
);

パラメータ

sync_optionパラメータは、RUN_SYNCプロシージャが実行する操作(SYNC、DELETEまたはREPLACE)を指定します。この操作は、synced_objectsパラメータのスコープ内のエンティティに対して実行されます。

RUN_SYNCプロシージャへのすべてのコールは、USER_LOAD_OPERATIONSビューを問い合せて同期のステータスおよび対応するlog_tableに関する情報を取得するために使用できる一意のoperation_idを返します。DBMS_DCAT$SYNC_LOGビューを問い合せると、現行のユーザーが最後に実行した同期操作のlog_tableに簡単にアクセスできます。詳細は、DBMS_DCAT$SYNC_LOGビューおよびロードの監視およびトラブルシューティングを参照してください。

パーティション化された論理エンティティまたはグルー表の同期

RUN_SYNCプロシージャは、次の3つすべてが当てはまる場合に、論理エンティティまたはGlue表ごとにパーティション化された外部表を作成します。

パーティション化された論理エンティティの同期の完全なエンドツーエンドの例については、例: パーティション化されたデータ・シナリオを参照してください。

パーティション化された論理エンティティ/グルー表の増分同期

RUN_SYNCプロシージャをコールするたびに、データベースと同期するOCIデータ・カタログ論理エンティティまたはAWS Glue表のセットを指定します。論理エンティティまたはグルー表が2つのRUN_SYNCコールに存在する場合、2番目のコールは既存の外部表を保持し、場合によっては変更します。次の表に、論理エンティティまたはグルー表がパーティション化されている場合にサポートされる論理エンティティまたはグルー表の変更を示します。

構文

PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );
PROCEDURE DBMS_DCAT.RUN_SYNC (
    synced_objects   IN  CLOB,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    operation_id     OUT NOCOPY NUMBER,
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
 );

パラメータ

例: すべてのOCIデータ・カタログ・エンティティの同期

次の例では、すべてのデータ・カタログ・エンティティが同期されます。

例: すべてのOCIデータ・カタログ・データ・アセットを同期するためのsynced_objectsパラメータ

次に、データ・カタログ内のすべての(オブジェクト・ストレージ)データ・アセットを同期するためのsynced_objectsパラメータの例を示します。

例: 特定のOCIデータ・カタログ・データ・アセットを同期するためのsynced_objectsパラメータ

次に、2つのデータ・アセットを同期するためのsynced_objectsパラメータの例を示します。

例: データ・アセット内の特定のOCIデータ・カタログ・エンティティを同期するためのsynced_objectsパラメータ

次に、データ・アセット内の2つのエンティティを同期するためのsynced_objectsパラメータの例を示します。

例: データ・アセット内の特定のOCIデータ・カタログ・フォルダおよびエンティティを同期するためのsynced_objectsパラメータ

次に、データ・アセット内の2つのフォルダと2つのエンティティを同期するためのsynced_objectsパラメータの例を示します。

例: すべてのAWS Glueデータ・カタログ・データベースを同期するためのsynced_objectsパラメータ

次に、AWS Glue Data Catalogのすべてのデータベースを同期するためのsynced_objectsパラメータの例を示します。

例: 2つのAWS Glueデータ・カタログ・データベースを同期するためのsynced_objectsパラメータ

次に、2つのAWS Glue Data Catalogデータベースを同期するためのsynced_objectsパラメータの例を示します。

例: 3つのAWS Glueデータ・カタログ・データベースを同期するためのsynced_objectsパラメータ

次に、AWS Glue Data Catalogデータベースの3つの表を同期するためのsynced_objectsパラメータの例を示します。

入力として、同期するオブジェクトのセット、エラー・セマンティクス、ログ・レベルおよび繰返し間隔を取ります。同期の動作の詳細は、DBMS_DCAT RUN_SYNCプロシージャを参照してください。

同期ジョブは1つのみです。forceパラメータがTRUEに設定されていないかぎり、別のジョブがすでに指定されている場合、CREATE_SYNC_JOBプロシージャは失敗します。forceをTRUEに設定すると、前のジョブが削除されます。

スケジューラ・ジョブが別の同期の進行中に実行しようとすると、スケジューラ・ジョブは失敗します。

構文

PROCEDURE DBMS_DCAT.CREATE_SYNC_JOB (
    synced_objects   IN CLOB,
    error_semantics  IN VARCHAR2 DEFAULT 'SKIP_ERRORS',
    log_level        IN VARCHAR2 DEFAULT 'INFO',
    repeat_interval  IN VARCHAR2,
    force            IN VARCHAR2 DEFAULT 'FALSE',
    grant_read       IN VARCHAR2 DEFAULT NULL,
    sync_option      IN VARCHAR2 DEFAULT 'SYNC',
    dcat_con_id      IN VARCHAR2 DEFAULT NULL
);

パラメータ

構文

PROCEDURE DBMS_DCAT.DROP_SYNC_JOB (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

パラメータ

構文

PROCEDURE DBMS_DCAT.DROP_SYNCED_SCHEMAS (
    dcat_con_id IN VARCHAR2 DEFAULT NULL
  );

パラメータ

例

RUN_SYNCプロシージャへのすべてのコールは、USER_LOAD_OPERATIONSのLOGFILE_TABLEフィールドが指す新しいログ表に記録されます。ログ表は2日後に自動的に削除され、ユーザーはDELETE_ALL_OPERATIONSプロシージャ(タイプがDCAT_SYNC)を使用してすべての同期ログをクリアできます。

DBMS_DCAT$SYNC_LOGビューは、最新のログ表を自動的に識別します。DBMS_DCAT$SYNC_LOGビューのスキーマを次に示します。アクセス権限は個々のログ表のスキーマと同じです。デフォルトでは、READはdbms_dcatロールおよびADMINユーザーに付与されます。

ログ表の形式は次のとおりです。