構文

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
 );

パラメータ

使用方法

このプロシージャをコールする必要があるのは、接続を設定する場合のみです。接続プロセスの一部として、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データ・カタログがあり、各カタログには、各リージョンに対応するサービス・エンドポイントを使用してアクセスできます。Autonomous Databaseインスタンスは、API DBMS_DCAT.SET_DATA_CATALOG_CONNを起動し、カタログが存在するリージョンのエンドポイントを指定することで、AWS Glueデータ・カタログに関連付けることができます。

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

この例では、Autonomous Databaseはuk-london-1リージョンのAWS Glueデータ・カタログに接続しています。これはAWS Glueデータ・カタログ接続であるため、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コールに論理エンティティ表またはGlue表が存在する場合、2つ目のコールでは既存の外部表が保持され、変更される可能性があります。次の表に、論理エンティティまたはGlue表がパーティション化されている場合にサポートされる論理エンティティまたはGlue表の変更を示します:

構文

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つのエンティティを同期するためのsynced_objectsパラメータの例を示します。

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

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

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

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

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

次に、AWS Glueデータ・カタログ・データベースから3つの表を同期するためのsynced_objectsパラメータの例を示します。

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

同期ジョブは1つのみ存在できます。強制パラメータがTRUEに設定されていないかぎり、別のジョブがすでに指定されていると、CREATE_SYNC_JOBプロシージャは失敗します。強制を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ユーザーに付与されます。

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