データセットの書き出し

この記事では、Customer Journey Analytics Export datasetsを使用して次の​ データ書き出しの使用例を実装する方法について説明します。

はじめに

Experience Platform Export datasetsを使用してデータをエクスポートすると、Customer Journey Analytics データビューから任意のクラウドストレージの宛先にデータをエクスポートできます。

他の書き出し方法とは異なり、書き出しデータセットには固定の行制限はありません。 クラウドストレージの宛先の容量によって書き出しサイズが制限されるため、データの完全で未加工のコピーが必要な場合は、この機能が適しています。

詳細情報

Experience Platformのデータレイクから生データセットを書き出すには、クラウドストレージの宛先を使用します。 この書き出しは、Experience Platform Destinationsの用語では、データセット書き出し先と呼ばれます。 概要については、​ データセットをクラウドストレージの宛先に書き出しを参照してください。

次のクラウドストレージの宛先がサポートされています。

EXPERIENCE PLATFORM UI

Experience Platform UIを使用して、データセットの書き出しをスケジュールできます。 この節では、関連する手順について説明します。

宛先を選択

データセットを書き出すクラウドストレージの宛先を決定したら、宛先を選択します。 優先クラウドストレージの宛先をまだ設定していない場合は、新しい宛先接続を作成する必要があります。

宛先の設定の一環として、次の項目を定義できます。

データセットを選択

宛先を選択した場合、次の​データセットを選択 ステップで、データセットのリストからデータセットを選択する必要があります。 複数のスケジュール済みクエリを作成し、データセットを同じクラウドストレージの宛先に送信する場合は、対応するデータセットを選択できます。 詳しくは、​ データセットの選択を参照してください。

データセット書き出しのスケジュール設定

最後に、スケジューリング​手順の一環として、データセットの書き出しをスケジュールします。 この手順では、スケジュールと、データセットの書き出しが増分かどうかを定義します。 詳しくは、​ データセットの書き出しをスケジュール ​を参照してください。

最終手順

選択内容を確認し、正しい場合は、データセットをクラウドストレージの宛先に書き出します。

最初に、​ データの書き出しを正常に実行するには、検証する必要があります。 データセットを書き出す場合、Experience Platformは、宛先の保存場所に1つまたは複数の.jsonまたは.parquet個のファイルを作成します。 設定した書き出しスケジュールに従って、新しいファイルがストレージの場所に格納されることを期待します。 Experience Platformは、選択した保存先の一部として指定した保存場所にフォルダー構造を作成し、書き出されたファイルを保存します。 書き出し時間ごとに、パターン folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMMに従って新しいフォルダーが作成されます。 デフォルトのファイル名はランダムに生成され、書き出されたファイルの名前は必ず一意になります。

Flow Service API

または、APIを使用して、データセットの書き出しを書き出し、スケジュールすることもできます。 関連する手順については、Flow Service APIを使用したデータセットの書き出しを参照してください。

基本を学ぶ

データセットを書き出すには、必要な権限があることを確認してください。 宛先がデータセットの書き出しをサポートしていることを確認します。 データセットをこの宛先に送信できます。 次に、API呼び出しで使用する必須ヘッダーとオプション ヘッダーの値を収集する必要があります。 また、データセットを書き出す宛先🔗の接続仕様とフロー仕様IDを特定する必要があります。

適格なデータセットの取得

書き出しの対象となるデータセット ​のリストを取得し、GET /connectionSpecs/{id}/configs APIを使用して、データセットがそのリストに含まれているかどうかを確認できます。

ソース接続の作成

次に、クラウドストレージの宛先に書き出すデータセットの一意のIDを使用して、​ ソース接続を作成する必要があります。 POST /sourceConnections APIを使用しています。

宛先への認証（ベース接続の作成）

クラウドストレージの宛先に資格情報を認証して安全に保存するには、🔗 POST /targetConnection APIを使用してベース接続を作成します。

書き出しパラメーターを指定

次に、POST /targetConnection APIを使用して、データセットの書き出しパラメーター🔗を格納する追加のターゲット接続を作成する必要があります。 これらのエクスポートパラメーターには、場所、ファイル形式、圧縮などが含まれます。

データフローの設定

データセットがクラウドストレージの宛先に確実にエクスポートされるようにするには、🔗 POST /flows APIを使用してデータフローを設定します。 この手順では、scheduleParams パラメーターを使用して、書き出しのスケジュールを定義できます。

データフローの検証

データフロー🔗の正常な実行を確認するには、GET /runs APIを使用して、データフローIDをクエリパラメーターとして指定します。 このデータフローIDは、データフローの設定時に返される識別子です。

​ データの書き出しが成功したことを確認します。 データセットを書き出す場合、Experience Platformは、宛先の保存場所に1つまたは複数の.jsonまたは.parquet個のファイルを作成します。 設定した書き出しスケジュールに従って、新しいファイルがストレージの場所に格納されることを期待します。 Experience Platformは、選択した保存先の一部として指定した保存場所にフォルダー構造を作成し、書き出されたファイルを保存します。 書き出し時間ごとに、パターン folder-name-you-provided/datasetID/exportTime=YYYYMMDDHHMMに従って新しいフォルダーが作成されます。 デフォルトのファイル名はランダムに生成され、書き出されたファイルの名前は必ず一意になります。