Azure Blob 接続
宛先の変更ログ changelog
2023 年 7 月の Experience Platform リリースでは、 Azure Blob 宛先に次のような新機能が提供されます。
- データセット書き出しのサポート。
- 追加のファイル命名オプション。
- 書き出されたファイルにカスタムファイルヘッダーを設定する機能(マッピングステップの改善による)
- 書き出された CSV データファイルの形式をカスタマイズする機能。
概要 overview
Azure Blob(以下「Blob」)は、Microsoft のクラウド用オブジェクトストレージソリューションです。このチュートリアルでは、Experience Platform ユーザーインターフェイスを使用して Blob 宛先を作成する手順を説明します。
API または UI を介して Azure Blob ストレージに接続する connect-api-or-ui
- Experience Platform ユーザーインターフェイスを使用して Azure Blob ストレージの場所に接続するには、以下の 宛先への接続 および この宛先に対するオーディエンスのアクティブ化 の節を参照してください。
- Azure Blob ストレージの場所にプログラムで接続するには、Flow Service API チュートリアルを使用した、ファイルベースの宛先に対するオーディエンスのアクティブ化 を参照してください。
はじめに
このチュートリアルは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
有効なBlobの宛先がすでにある場合は、このドキュメントの残りをスキップして、「宛先へのオーディエンスの有効化🔗に関するチュートリアルに進んでください。
サポートされるオーディエンス supported-audiences
このセクションでは、この宛先にエクスポートできるオーディエンスのタイプについて説明します。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
データセットの書き出し export-datasets
この宛先では、データセットの書き出しをサポートしています。 データセットエクスポートの設定方法について詳しくは、チュートリアルを参照してください。
- Experience Platform ユーザー インターフェイスを使用してデータセットを エクスポートする方法。
- 流量 サービス API を使用してプログラムでデータセットを エクスポートする方法。
書き出されたデータのファイル形式 file-format
オーディエンスデータ を書き出すと、Experience Platformは、指定されたストレージの場所に .csv、parquet または .json ファイルを作成します。 ファイルについて詳しくは、Audience Activation チュートリアルの 書き出しでサポートされるファイル形式 の節を参照してください。
データセット を書き出すと、Experience Platformは、指定されたストレージの場所に .parquet または .json ファイルを保存します。 ファイルについて詳しくは、データセットの書き出しチュートリアルの データセットの書き出しが成功したことを確認する の節を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つの節でリストされているフィールドに入力します。
宛先に対する認証 authenticate
宛先に対して認証を行うには、必須フィールドに入力して [ Connect to destination] を選択します。
-
Connection string: 接続文字列は、BLOB ストレージ内のデータにアクセスするために必要です。 Blob 接続文字列のパターンは
DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}で始まります。- Blob 接続文字列の設定について詳しくは、Microsoftドキュメントの Azure Storage アカウントの接続文字列を構成するを参照してください。
-
Encryption key:オプションで、RSA 形式の公開キーを添付して、エクスポートされたファイルに暗号化を追加できます。 正しい形式の暗号化キーの例については、以下の画像を参照してください。
宛先の詳細の入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
-
Name:この宛先を識別するのに役立つ名前を入力します。
-
Description:この宛先の説明を入力します。
-
Folder path:エクスポートされたファイルホスト宛先フォルダーへのパスを入力します。
-
Container:この宛先で使用する Azure Blob Storage コンテナの名前を入力します。
-
File type:Experience Platform書き出すファイルに使用する形式を選択します。 CSVオプションを選択すると、ファイル形式オプションを設定こともできます。
-
Compression format:Experience Platformエクスポートするファイルに使用する圧縮タイプを選択します。
-
Include manifest file: エクスポートの場所、エクスポート サイズなどに関する情報を含むマニフェスト JSON ファイルをエクスポートに含める場合は、このオプションをオンに切り替えます。 マニフェストには 形式
manifest-<<destinationId>>-<<dataflowRunId>>.jsonを使用して名前が付けられます。 サンプルマニフェストファイル表示。マニフェストファイルには、次のフィールドが含まれています。flowRunId:書き出されたファイルを生成した データフロー実行 。scheduledTime: ファイルが書き出された時間(UTC 単位)。exportResults.sinkPath:書き出されたファイルが格納されるストレージの場所のパス。exportResults.name:エクスポートするファイルの名前。size:エクスポートするファイルのサイズ(バイト単位)。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の指定が完了したら、 [ Next] を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
- データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles、View Segments アクセス制御権限 が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- ID を書き出すには、View Identity Graph アクセス制御権限 が必要です。
{width="100" modal="regular"}
この宛先へのオーディエンスをアクティブ化する手順については、 オーディエンスデータをアクティブ化して宛先をバッチプロファイルエクスポートする を参照してください。
データの正常な書き出しの検証 exported-data
データが正常に書き出されたかどうかを確認するには、Azure Blob ストレージを確認し、書き出されたファイルに想定されるプロファイル母集団が含まれていることを確認してください。