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 ロールを付与するよう依頼してください。

• エントリ グループを作成、管理する: Dataplex Catalog 管理者 （roles/dataplex.catalogAdmin）、 Dataplex Catalog 編集者 （roles/dataplex.catalogEditor）、または Dataplex エントリ グループ オーナー （roles/dataplex.entryGroupOwner）をプロジェクトに対して設定します。
• BigQuery Data Transfer Service 転送ジョブを作成、管理する: BigQuery 管理者 （roles/bigquery.admin）: プロジェクトに対する。
• Cloud Logging でログを表示する: ログビューア (roles/logging.viewer)。

また、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 コネクタを構成する

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

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

次のステップ

• コネクタ ジョブを管理する方法を学習する。