Data Catalog は非推奨となりました。Data Catalog から Knowledge Catalog にプログラムによるワークフロー、スクリプト、クライアント ライブラリ、Terraform 構成を移行する場合は、Dataplex API を使用するようにコードを更新する必要があります。
このドキュメントでは、Data Catalog のリソース、機能、API メソッドと、Dataplex API の同等のリソース、機能、API メソッドのマッピングについて詳しく説明します。
移行プロセスの手順については、 Data Catalog から Knowledge Catalog への移行をご覧ください。 API リファレンス ドキュメントについては、 Dataplex API REST ドキュメントと Dataplex API RPC ドキュメントをご覧ください。
リソース マッピング
次の表に、Data Catalog のリソースと Knowledge Catalog のリソースの関係を示します。
| Data Catalog リソース | Knowledge Catalog リソース | 説明 |
|---|---|---|
| 公開タグ テンプレート | アスペクト タイプ（global） |
タグ テンプレートは、
リージョン間で使用できる Data Catalog のリージョン リソースです。Knowledge Catalog の global アスペクト
タイプに対応しています。 |
| 公開タグ | オプションのアスペクト | 公開タグは、Knowledge Catalog のエントリまたは 列にアタッチされたオプションのアスペクトに対応しています。 |
| エントリ グループ | エントリ グループ | エントリ グループは、両方の
サービスで組織コンテナとセキュリティ コンテナとして機能します。ソース Google Cloud の場合、
@bigqueryなどのシステム エントリ グループは、プロジェクトごとに自動的に設定されます。 |
| カスタム エントリ | カスタム エントリ（必須アスペクト付き） | 標準のカスタム エントリ プロパティは、カスタム エントリの EntryType で定義された必須アスペクト
としてモデル化されます。 |
| システム（Google Cloud）のエントリ | システム エントリ（必須アスペクト付き） | 組み込みエンティティ（Schema for
BigQuery テーブルなど）を記述するメタデータは、システム定義のアスペクト タイプの必須アスペクトでキャプチャされます。 |
| ビジネス用語集 | ビジネス用語集 | 企業全体でビジネス コンテキストを標準化するビジネス用語の分類。 |
機能の比較
次の表は、Knowledge Catalog と Data Catalog のメタデータ管理機能を比較したものです。
| 機能 | Knowledge Catalog | Data Catalog |
|---|---|---|
| サポートされている Google Cloud ソース | サポートされている ソース Google Cloud で説明されているすべてのソース。 | Data Catalog のドキュメントで説明されているすべてのソース。 |
| カスタムソースの取り込み | エントリタイプで定義された、管理対象の構造を持つカスタム エントリへの取り込み。 Data Catalog のカスタム エントリとエントリ グループは、Knowledge Catalog の
|
汎用カスタム エントリへの取り込み。 |
| メタデータ拡張 | ビジネス用語集、アスペクト、アスペクト タイプを使用してキャプチャされます。 エントリリンクがサポートされています。アスペクトをエントリ リンクに直接アタッチできます。 |
ビジネス用語集、タグ、タグ テンプレートを使用してキャプチャされます。 エントリリンクはサポートされていません。 |
| エントリリンク | サポートされています。`synonym`、`
definition`、`related`、`
schema-join` などの組み込みタイプを使用すると、エントリと列を接続できます。 |
利用できません。 |
| メタデータ変更フィード | Pub/Sub にストリーミングされるほぼリアルタイムのメタデータ変更通知。 | 利用できません。 |
| 検索 | 検索は、同じ組織と VPC Service Controls 境界内のサポートされているすべての Google Cloud ソース、カスタム エントリ、アスペクト、移行された Data Catalog コンテンツに対して実行されます。 | 検索は、サポートされているソース、カスタム エントリ、Data Catalog で作成されたタグ に対して実行されます。 |
| データリネージ | Dataplex API を使用してアセットノードのエントリの詳細を取得します。 コンソール Google Cloud に、アタッチされたアスペクトが表示されます。 | Data Catalog API を使用してエントリの詳細を取得します。 |
| ビジネス用語集 | ビジネス用語の分類法を構築し、 データアセット（エントリ）と列の両方に関連付けることができます。 | 用語を列に関連付けることができます。 |
Data Catalog API メソッドを Knowledge Catalog にマッピングする
次の表に、Data Catalog API（google.cloud.datacatalog.v1）と Dataplex API（google.cloud.dataplex.v1.CatalogService）のメソッドごとのマッピングを示します。
エントリ グループ
エントリ グループのコンセプトは、両方のサービスで一貫しています。
| Data Catalog API メソッド | Dataplex API メソッド |
|---|---|
projects.locations.entryGroups.create（REST）CreateEntryGroup（RPC） |
projects.locations.entryGroups.create（REST）CreateEntryGroup（RPC） |
projects.locations.entryGroups.get（REST）GetEntryGroup（RPC） |
projects.locations.entryGroups.get（REST）GetEntryGroup（RPC） |
projects.locations.entryGroups.patch（REST）UpdateEntryGroup（RPC） |
projects.locations.entryGroups.patch（REST）UpdateEntryGroup（RPC） |
projects.locations.entryGroups.delete（REST）DeleteEntryGroup（RPC） |
projects.locations.entryGroups.delete（REST）DeleteEntryGroup（RPC） |
projects.locations.entryGroups.list（REST）ListEntryGroups（RPC） |
projects.locations.entryGroups.list（REST）ListEntryGroups（RPC） |
エントリ
データアセットを表すエントリのコンセプトは、両方のサービスで一貫しています。
タグ テンプレートとアスペクト タイプ
アスペクト タイプは、Data Catalog タグ テンプレートの後継です。
| Data Catalog API メソッド | Dataplex API メソッド |
|---|---|
projects.locations.tagTemplates.create（REST）CreateTagTemplate（RPC） |
projects.locations.aspectTypes.create（REST）CreateAspectType（RPC） |
projects.locations.tagTemplates.get（REST）GetTagTemplate（RPC） |
projects.locations.aspectTypes.get（REST）GetAspectType（RPC） |
projects.locations.tagTemplates.patch（REST）UpdateTagTemplate（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
projects.locations.tagTemplates.delete（REST）DeleteTagTemplate（RPC） |
projects.locations.aspectTypes.delete（REST）DeleteAspectType（RPC） |
catalog.search（REST）with type=tag_templateSearchCatalog（RPC）with type=tag_template |
projects.locations.aspectTypes.list（REST）ListAspectTypes（RPC） |
タグ テンプレートのフィールド
タグ テンプレート フィールドは、アスペクト タイプの metadata_template フィールドの内容に対応しています。変更した metadata_template で UpdateAspectType を使用して、フィールドを作成、更新、名前変更、削除します。
| Data Catalog API メソッド | Dataplex API メソッド |
|---|---|
projects.locations.tagTemplates.fields.create（REST）CreateTagTemplateField（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
projects.locations.tagTemplates.fields.patch（REST）UpdateTagTemplateField（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
projects.locations.tagTemplates.fields.rename（REST）RenameTagTemplateField（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
projects.locations.tagTemplates.fields.delete（REST）DeleteTagTemplateField（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
タグ テンプレートのフィールドの列挙値
対応するアスペクト タイプの metadata_template フィールドを更新して、列挙値を変更します。
| Data Catalog API メソッド | Dataplex API メソッド |
|---|---|
projects.locations.tagTemplates.fields.enumValues.rename（REST）RenameTagTemplateFieldEnumValue（RPC） |
projects.locations.aspectTypes.patch（REST）UpdateAspectType（RPC） |
タグとアスペクト
アスペクトは、Data Catalog タグの後継です。アスペクトは親エントリまたはエントリリンクに直接カプセル化され、update_mask を使用して UpdateEntry メソッドで管理されます。
| Data Catalog API メソッド | Dataplex API メソッド |
|---|---|
projects.locations.entryGroups.entries.tags.create（REST）CreateTag（RPC） |
projects.locations.entryGroups.entries.patch（REST）UpdateEntry（RPC） |
projects.locations.entryGroups.entries.tags.list（REST）ListTags（RPC） |
projects.locations.entryGroups.entries.get（REST）GetEntry（RPC）
注: レスポンスのアスペクトをフィルタするには、 |
projects.locations.entryGroups.entries.tags.patch（REST）UpdateTag（RPC） |
projects.locations.entryGroups.entries.patch（REST）UpdateEntry（RPC） |
projects.locations.entryGroups.entries.tags.delete（REST）DeleteTag（RPC） |
projects.locations.entryGroups.entries.patch（REST）UpdateEntry（RPC） |
ポリシータグと分類
ポリシータグと分類の API は変更されないため、移行する必要はありません。
Knowledge Catalog で対象外の機能
次の Data Catalog の動作と機能は、Knowledge Catalog ではサポートされていないか、動作が異なります。
- 非公開アスペクト タイプ: 非公開アスペクトと非公開アスペクト タイプ（Data Catalog の非公開タグと非公開タグ テンプレートに対応）のコンセプトは存在しません。すべてのカスタム アスペクト タイプは、プロジェクトとエントリ グループの Identity and Access Management 権限に則って管理されます。
- ポリシータグの検索:
policytag述語またはpolicytagid述語を使用したポリシータグの検索は、カタログ検索ではサポートされていません。 - 権限の転送: Data Catalog のカスタム エントリ グループ、カスタム エントリ、タグ テンプレート、タグを Knowledge Catalog にインポートしても、元の権限は 引き継がれません。インポートしたリソースの IAM 権限を 構成 する必要があります。以前の権限と 置換権限の詳細な比較については、 Data Catalog と Knowledge Catalog 間の IAM 権限のマッピングをご覧ください。
- Sensitive Data Protection の検査結果: Sensitive Data Protection の検査結果 を Knowledge Catalog に直接送信することはできません。代わりに、検査結果を Data Catalog に送信し、その結果を Knowledge Catalog に移行します。
- プロジェクト間のタイプの一覧表示: 単一の API 呼び出しでプロジェクト全体のエントリタイプ、エントリリンク タイプ、 アスペクト タイプを一覧表示することはできません。リクエストは 単一のプロジェクトにスコープ設定する必要があります。
- 管理者検索: 管理者検索（完全な再現率）は サポートされていません。代わりに、メタデータを Cloud Storage にエクスポートし、BigQuery を使用してクエリします。