Oracle からメタデータをインポートする

このドキュメントでは、Knowledge Catalog コネクタを使用して、Oracle から Knowledge Catalog（以前の Dataplex Universal Catalog）にメタデータをインポートする方法について説明します。

このコネクタは、オンプレミス、Google Cloud、または他のクラウド環境でホストされている Oracle インスタンスをサポートしています。

Oracle からメタデータをインポートする前に、次のタスクを完了します。

  1. 必要なロールと権限を付与します。
  2. Knowledge Catalog API と BigQuery Data Transfer Service API を有効にします。
  3. Oracle の前提条件を満たします。
  4. ネットワークの前提条件を満たします。

IAM のロールと権限

Knowledge Catalog コネクタ ジョブを作成して管理するには、Knowledge Catalog と BigQuery Data Transfer Service の権限を付与する Identity and Access Management（IAM）ロールが必要です。

Oracle コネクタの構成に必要な権限を取得するには、管理者に次の IAM ロールを付与するよう依頼してください。

また、BigQuery Data Transfer Service サービス エージェント（service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com）に dataplex.entryGroups.import 権限または Dataplex エントリ グループのインポーター（roles/dataplex.entryGroupImporter）ロールを付与する必要があります。このロールは、プロジェクト レベルまたはエントリ グループ レベルで付与できます。

ロールの付与の詳細については、アクセスの管理をご覧ください。

API を有効にする

Knowledge Catalog API と BigQuery Data Transfer Service API を有効にします。

API を有効にする

Oracle の前提条件

Oracle 転送の前提条件を満たしていることを確認します。詳細については、BigQuery Data Transfer Service のドキュメントの Oracle の前提条件をご覧ください。

BigQuery Data Transfer Service の前提条件に加えて、Oracle インスタンスは次の要件を満たしている必要があります。

  • 最小バージョン: type や parentContainer などのデータベース メタデータ属性をサポートするには、Oracle バージョン 12 以降が必要です。

  • 最小権限: データベース ユーザーに次の権限を付与する必要があります。

    基本権限（すべての構成で必要）:

    GRANT SELECT_CATALOG_ROLE TO USER_NAME;
GRANT CREATE SESSION TO USER_NAME;
GRANT SELECT ON SYS.COL$ TO USER_NAME;

    特定のスキーマにアクセスする権限（Oracle バージョン 23 以降）:

    GRANT SELECT ANY TABLE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT EXECUTE ANY TYPE ON SCHEMA TARGET_SCHEMA TO USER_NAME;
GRANT ALTER ANY TRIGGER ON SCHEMA TARGET_SCHEMA TO USER_NAME;

    他のすべてのスキーマにアクセスする権限:

    GRANT SELECT ANY TABLE TO USER_NAME;
GRANT EXECUTE ANY PROCEDURE TO USER_NAME;
GRANT EXECUTE ANY TYPE TO USER_NAME;
GRANT ALTER ANY TRIGGER TO USER_NAME;

    次のように置き換えます。

    • USER_NAME: 構成するデータベース ユーザー。
    • TARGET_SCHEMA: アクセスする Oracle スキーマの名前。

ネットワーキングの前提事項

プライベート ネットワーク内の プライベート IP アドレスを使用して外部データベースまたはサードパーティのクラウド データソースに 安全に接続し、BigQuery Data Transfer Service がデータベースにアクセスできるようにするには、Private Service Connect を介した 接続用のネットワーク アタッチメントが必要です。

パブリック IP アドレスを使用してオンプレミス環境またはクラウドホスト型インスタンスに接続する場合、ネットワーク アタッチメントは必要ありません。

Oracle コネクタを構成する

Google Cloud コンソールまたは API を使用して Oracle コネクタを構成します。

コンソール

  1. Google Cloud コンソールで、[Knowledge Catalog] ページに移動します。

    Knowledge Catalog に移動

  2. ナビゲーション メニューの [管理] セクションで、[コネクタ] をクリックします。

  3. [Add connection] をクリックします。

  4. [コネクタ] リストで、[Oracle] カードを選択します。

  5. [データソースの詳細] セクションで、Oracle インスタンスの接続の詳細を指定します。

    • [ネットワーク アタッチメント] で、必要に応じて既存のネットワーク アタッチメントを選択するか、作成します。
    • [ホスト]、[ポート]、[データベース名]、[接続タイプ]、[ユーザー名]、[パスワード] を入力します。
    • TLS を使用する場合は、[TLS Mode] を選択し、[Trusted PEM Certificate] を指定します。詳細については、TLS 構成をご覧ください。
    • [インポートする Oracle メタデータ オブジェクト] で、[参照] をクリックしてオブジェクトを選択します。

  6. [宛先の設定] セクションで、次の操作を行います。

    • [参照] をクリックし、インポートしたメタデータを保存する既存の Knowledge Catalog エントリ グループを選択するか、[新しいエントリ グループを作成] をクリックします。
    • エントリ グループの権限を今すぐ設定するか、後で設定するかを選択します。ユーザーがインポートされたメタデータを表示できるように権限を設定することをおすすめします。プロジェクト レベルで BigQuery Data Transfer Service サービス エージェント（service-PROJECT_NUMBER@gcp-sa-bigquerydatatransfer.iam.gserviceaccount.com）に Dataplex エントリ グループ インポーター（roles/dataplex.entryGroupImporter）ロールまたは dataplex.entryGroups.import 権限を付与していない場合は、エントリ グループ レベルで付与する必要があります。

  7. [コネクタ構成名] セクションの [表示名] に、メタデータ インポート ジョブの名前を入力します。

  8. [スケジュール オプション] セクションで、メタデータ インポート ジョブの頻度を構成します。[オンデマンド] を選択した場合、ジョブは手動でトリガーしたときにのみ実行されます。

  9. 省略可: [通知オプション] セクションで、ジョブの失敗に関するメール通知または Pub/Sub 通知を構成します。

  10. 省略可: [詳細オプション] セクションで、暗号化の設定を行います。顧客管理の暗号鍵（CMEK）を選択した場合、この鍵は Knowledge Catalog メタデータ インポート ジョブを開始する前にステージングされた一時データの暗号化に使用されます。送信先 Knowledge Catalog エントリ グループのメタデータの暗号化には使用されません。

  11. [保存] をクリックします。

REST

projects.locations.transferConfigs.create メソッドを使用します。TransferConfig リソースで、次のフィールドを構成します。

  • dataSourceId フィールドを "oracle" に設定します。
  • metadataDestination フィールドで、ターゲット Knowledge Catalog エントリ グループのリソースパスを使用して dataplexConfiguration オブジェクトを入力します。projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>

ジョブを作成すると、Knowledge Catalog は構成に従って最初の実行をスケジュール設定します。手動で開始することもできます。

Oracle メタデータの検索と表示

  1. Google Cloud コンソールで、[Knowledge Catalog] の [検索] ページに移動します。

    [検索] に移動

  2. [フィルタ] パネルで、[プロジェクト]、[システム]、[タイプ エイリアス] の各セクションを使用して、Oracle アセットをフィルタできます。[システム] セクションで、[インポートされたコンテキスト] を選択します。このフィルタを選択すると、[マネージド コネクタ] サブセクションが開きます。[Oracle] を選択して、すべての Oracle メタデータをフィルタします。

  3. 検索フィールドを使用して検索クエリを実行できます。キーワード検索または自然言語検索を実行できます。たとえば、キーワード検索ですべての Oracle テーブルを表示するには、「system=ORACLE AND type=TABLE」と入力します。

    リソースの検索の詳細については、Knowledge Catalog でリソースを検索するをご覧ください。検索フィールドで使用できる式の詳細については、Knowledge Catalog の検索構文をご覧ください。

  4. LookupContext API を使用して、特定の Oracle リソースの LLM コンテキストを取得することもできます。

次のステップ