用語集とエントリリンクのインポートとエクスポートについて

このドキュメントでは、Knowledge Catalog（以前の Dataplex Universal Catalog）でビジネス用語集とエントリ リンクをインポートおよびエクスポートする方法の概要について説明します。

Knowledge Catalog のビジネス用語集を使用すると、共通のビジネス用語集を定義し、それらの用語を物理データアセットに関連付けることができます。カタログが大きくなると、Google Cloud コンソールでこれらの用語とその関係を個別に管理することが難しくなる可能性があります。

ビジネス用語集を大規模に管理するには、用語集（カテゴリと用語）とエントリリンク（用語とデータアセット間の関連付け）を一括でインポートおよびエクスポートできます。

用語

インポート / エクスポート ユーティリティを使用する前に、次の主要コンポーネントについて理解しておいてください。

  • 用語集リソース: ビジネス用語を確立するカテゴリと用語で構成されます。

  • エントリリンク: リソース間の関係または関連付け。Knowledge Catalog は、次の 3 種類のエントリリンクをサポートしています。

    • definition: 用語集の用語を特定のデータアセット（BigQuery 列など）に関連付けます。
    • related: 関連する 2 つの用語集の用語間の関係を確立します。
    • synonym: 2 つの同義語の用語集用語間の関係を確立します

用語集とエントリリンクのインポートとエクスポートの方法

Knowledge Catalog では、用語集の一括管理に主に次の 2 つの方法がサポートされています。自動化のニーズと希望するインターフェースに最も適した方法を選択します。

  • JSON ベースのメタデータのインポート
  • インポートとエクスポート用の Google スプレッドシート ベースのユーティリティ

JSON ベースのメタデータのインポート

これは、組み込みのフルマネージド Knowledge Catalog メカニズムです。Dataplex API を使用して、JSON 形式のメタデータ ファイルで定義された用語集の用語とその関連付けをインポートします。

ユースケースの例: 毎日スケジュールされたデータ パイプラインの一部として、Knowledge Catalog のメタデータを自動的に更新する（外部のエンタープライズ データベースから用語を直接同期するなど）。

詳細については、JSON ファイルを使用して用語集とエントリリンクをインポートするをご覧ください。

インポートとエクスポート用の Google スプレッドシート ベースのユーティリティ

これは、dataplex-labs リポジトリで提供されるオープンソースのスクリプトベースのアプローチです。Python スクリプトを使用して、Google スプレッドシートと Knowledge Catalog の間で用語集のメタデータを同期します。

ユースケースの例: データ ガバナンス チームが、技術的な知識のないビジネス関係者と協力して、数十もの新しいビジネス用語を起草してレビューしたいと考えています。このチームは、このスプレッドシート ベースの方法を使用して、管理者がスクリプトを実行して用語を一括で Knowledge Catalog にアップロードする前に、全員が Google スプレッドシートで用語を編集、コメント、承認できるようにしています。

詳細については、次のドキュメントをご覧ください。

一般的なユースケース: Google スプレッドシートとのラウンドトリップ編集

一般的な管理ワークフローは、ラウンドトリップ編集を実行することです。これには、既存のカタログ設定のエクスポート、一括変更、Knowledge Catalog への変更の適用が含まれます。

次のワークフローは、このプロセスを実行する方法を示しています。

  1. 既存のメタデータを Knowledge Catalog から Google スプレッドシートにエクスポートします。

    用語集のエクスポート ユーティリティとエントリリンクのエクスポート ユーティリティを使用して、既存の用語集構造とエントリリンクを Google スプレッドシートに抽出します。

  2. Google スプレッドシート内でメタデータを変更します。

    Google スプレッドシートで必要な変更を行います。対称リンク（synonym や related エントリリンクなど）は、重複する行を避けるためにエクスポート時に単一の方向に簡略化されるため、管理は 1 回のみで済みます。

    必要な列スキーマに沿って、それぞれのシートに新しい行を追加できます。説明や表示名などの詳細を、行で直接変更することもできます。

  3. Google スプレッドシートから Knowledge Catalog に変更をステージングしてインポートします。

    まず、用語集のインポート ユーティリティを実行します。これにより、新しい用語やカテゴリをリンクする前に、ビジネス用語集で正常に作成されます。

    エントリリンクのインポート ユーティリティを実行します。このユーティリティは、更新された関連付けを読み取り、Cloud Storage バケットにステージングして、definition、related、synonym のリンクを新しく更新された用語集に適用します。

次のステップ