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

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

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

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

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

IAM のロールと権限

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

MySQL コネクタの構成に必要な権限を取得するには、管理者に次の 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 を有効にする

MySQL の前提条件

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

BigQuery Data Transfer Service の前提条件に加えて、MySQL データベースはメタデータ抽出に関して次の要件を満たしている必要があります。

• 最小バージョン: MySQL バージョン 8.0 以降。
• 必要な最小権限: 抽出ツールが INFORMATION_SCHEMA を正常にクエリしてメタデータを収集するには、特定の権限が必要です。

これらの権限により、次のメタデータが確実にカバーされます。

• インスタンスとデータベースの情報: ホスト名、ポート、バージョン、スキーマ構成。
• テーブルと列: コア構造、データ型、運用メタデータ（サイズや行数など）。
• インデックスとパーティション: セカンダリ インデックス、パーティション メソッド、式。
• ビュー: 仮想テーブルの構造と定義。
• ルーティン: ストアド プロシージャ、関数、およびそれらのパラメータ。
• 制約: 主キー、外部キー、一意、チェックの制約の詳細。
• トリガー: トリガーの定義とイベントのタイミング。

これらの権限を付与するには、次の SQL スクリプトを実行します。

1. ユーザーを作成します。

   CREATE USER 'USERNAME'@'%'
   IDENTIFIED BY 'PASSWORD';
   

2. メタデータへのアクセス権を付与します。単一のターゲット データベースまたはインスタンス上のすべてのデータベースへのアクセス権を付与できます。

   単一のターゲット データベースまたはスキーマへのアクセス権を付与するには:

   GRANT SELECT, SHOW VIEW, REFERENCES, EXECUTE, TRIGGER
   ON DATABASE_NAME.*
   TO 'USERNAME'@'%';
   

   または、インスタンス上のすべてのデータベースに対するアクセス権を付与するには:

   GRANT SELECT, SHOW VIEW, REFERENCES, EXECUTE, TRIGGER
   ON *.*
   TO 'USERNAME'@'%';
   

3. 抽出ツールがインスタンスで使用可能なすべてのデータベースを一覧表示できるようにします。

   GRANT SHOW DATABASES ON *.* TO 'USERNAME'@'%';
   

4. 変更を適用します。

   FLUSH PRIVILEGES;
   

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

• USERNAME: 構成するデータベース ユーザー。
• PASSWORD: データベース ユーザーのパスワード。
• DATABASE_NAME: アクセスする MySQL データベースの名前。

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

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

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

MySQL コネクタを構成する

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

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

次のステップ

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