Catalog Service概要

Catalog Service は、Adobe Experience Platform内のデータの位置と系統に関する記録システムです。Experience Platformに取り込まれるすべてのデータはData Lakeにファイルやディレクトリとして保存されますが、Catalogは、参照や監視のために、これらのファイルやディレクトリのメタデータと説明を保持します。

簡単に言うと、Catalogはメタデータストア(「カタログ」)の役割を果たし、Experience Platform内でデータに関する情報を見つけることができます。 Catalogを使って、次の質問に答えることができます。

  • データの場所
  • データが処理のどの段階であるか。
  • データに対してどのようなシステムまたはプロセスが作用しているか。
  • 正常に処理されたデータの量
  • 処理中に発生したエラー

Catalog には、基本的なCRUD操作を使用して Platform メタデータをプログラムで管理できるRESTful APIが用意されています。詳しくは、『カタログ開発者ガイド』を参照してください。

Catalog および Experience Platform サービス

Catalog Serviceが追跡するリソースは、複数のExperience Platformサービスで使用されます。 Catalog’sの機能を最大限に活用するために、これらのサービスとCatalogとのやり取り方を理解することをお勧めします。

Experience Data Model (XDM)システム

Experience Data Model (XDM)システムは、顧客体験データを Platform 編成する標準化されたフレームワークです。Experience Platform は、XDM スキーマを活用して、一貫した再利用可能な方法でデータの構造を記述します。

データがPlatformに取り込まれると、そのデータの構造はXDMスキーマにマッピングされ、Data Lakeにデータセットの一部として保存されます。 各データセットのメタデータはCatalog Serviceによって追跡されます。この中には、データセットが準拠するXDMスキーマへの参照が含まれています。

XDM システムの一般的な情報については、「XDM システムの概要」を参照してください。

Data Ingestion

Experience Platform 複数のソースからデータを取り込み、レコードをデータセットとして内に保持 Data Lakeします。Catalog 取り込み元や取り込み方法に関係なく、これらのデータセットのメタデータを追跡します。

バッチ取り込み方法を使用する場合、Catalogはバッチファイルの追加のメタデータも追跡します。 バッチとは、単一の単位として取得される 1 つ以上のファイルで構成されるデータの単位です。Catalog これらのバッチファイルのメタデータと、取り込み後に保持されるデータセットを追跡します。バッチメタデータには、正常に取得されたレコードの数、失敗したレコードおよび関連するエラーメッセージに関する情報が含まれます。

詳しくは、「データ取得の概要」を参照してください。

Catalog オブジェクト

前の節で説明したように、Catalogは、他のPlatformサービスで使用されるいくつかの種類のリソースと操作のメタデータを追跡します。 Catalog は、このメタデータをカプセル化する「オブジェクト」の独自のストアを維持します。Catalog オブジェクトは Platform データをクエリー可能に表したもので、データ自体にアクセスする必要なく、データの検索、監視、ラベル付けを行うことができます。

次の表に、Catalogがサポートする各種オブジェクトの概要を示します。

オブジェクト API エンドポイント 定義
アカウント /accounts ソース接続を作成する場合は、認証資格情報を指定する必要があります。アカウントは、特定の種類の接続の作成に使用された認証資格情報のコレクションを表します。各接続には、Catalogで保持され、Azure Key Vaultで保護される一意のパラメーターのセットがあります。
バッチ /batches バッチとは、単一の単位として取得される 1 つ以上のファイルで構成されるデータの単位です。Catalogのバッチオブジェクトは、バッチの取り込み指標(ディスク上で処理されたレコード数やサイズなど)の概要を示し、バッチ処理の影響を受けたデータセット、表示、その他のリソースへのリンクを含む場合があります。
接続 /connections 接続はソースコネクタの単一インスタンスです。接続は組織に固有で、コネクタの種類に適した認証資格情報を使用して構成されます。
コネクタ /connectors コネクタは、他のAdobeアプリケーション(Adobe AnalyticsやAdobe Audience Managerなど)、サードパーティのクラウドストレージソース(Azure Blob、Amazon S3、FTPサーバー、SFTPサーバーなど)、およびサードパーティのCRMシステム(Microsoft Dynamics、Salesforceなど)からデータを収集するソース接続の方法を定義します。
データセット /dataSets データセットは、スキーマ(列)とフィールド(行)を含むデータ(通常はテーブル)の収集に使用されるストレージと管理の構成体です。詳しくは、データセットの概要を参照してください。
データセットファイル /datasetFiles データセットファイルは、Platformに保存されたデータのブロックを表します。 リテラルファイルのレコードについては、ファイルのサイズ、ファイルに含まれるレコードの数、およびファイルを取得したバッチへの参照を見つけることができます。

次の手順

このドキュメントはCatalog Serviceの紹介と、Experience Platformの範囲内での機能の仕組みを提供しています。 Catalog APIの異なるエンドポイントとの対話手順については、Catalog 開発者ガイドを参照してください。 API 応答で返されるデータを制限するベストプラクティスに従うために、カタログデータのフィルタリングに関するガイドも参照することをお勧めします。

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free