ファイルベースの宛先に対するファイル形式オプションの設定
書き出したファイルに対して様々なファイル形式オプションを設定するオプションは、ファイルベースの宛先(Amazon S3、Azure Blob または SFTP など)に接続するときに使用できます。
Experience Platform UI を使用して、書き出したファイルに対して様々なファイル形式オプションを設定できます。 書き出されたファイルの複数のプロパティを変更して、側のファイル受信システムの要件に合わせて、Experience Platformから受信したファイルを最適に読み取って解釈できます。
CSV ファイルのファイル形式設定 file-configuration
ファイル形式オプションを表示するには、宛先への接続 ワークフローを開始します。 データタイプ:セグメントおよび ファイルタイプ:CSV を選択して、書き出されたCSV ファイルで使用可能なファイル形式設定を表示します。
区切り delimiter
このコントロールを使用して、書き出されたCSV ファイルの各フィールドと値に区切り記号を設定します。 利用可能なオプションは次のとおりです。
- コロン
(:) - カンマ
(,) - パイプ
(|) - セミコロン
(;) - タブ
(\t)
例 delimiter-examples
書き出されたCSV ファイル内のコンテンツの以下の例と、UI内の各選択を表示します。
- コロン
(:)が選択された出力の例:male:John:Doe - カンマ
(,)が選択された出力の例:male,John,Doe - パイプ
(|)が選択された出力例:male|John|Doe - セミコロン
(;)が選択された出力の例:male;John;Doe - タブ
(\t)が選択された出力の例:male \t John \t Doe
引用符文字 quote-character
このオプションを使用して、二重引用符を削除するか、書き出した文字列内に保持するかを制御します。
使用できる選択肢は次のとおりです。
- Null文字(\0000) 。 書き出したCSV ファイルから二重引用符を削除するには、このオプションを使用します。
- 二重引用符(") 。 文字列値に区切り記号または二重引用符が含まれている場合は、このオプションを使用します。 このオプションを使用すると、書き出したCSV ファイル内に区切り記号または二重引用符を保持できるため、どの値がどのフィールドに対応するかを正しく特定できます。
例 quote-character-examples
入力値Anna,"Doe,John"を考慮してください。
書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。
- Null文字(\0000) を選択した出力の例:
Anna,Doe,John - 二重引用符(") が選択された出力の例:
Anna,"Doe,John"
エスケープ文字 escape-character
既に引用符で囲まれた値の中で引用符をエスケープする場合は、このオプションを使用します。 例えば、文字列の一部が既に二重引用符で囲まれている二重引用符で囲まれた文字列がある場合、このオプションは便利です。 このオプションは、内側の二重引用符を置き換える文字を決定します。 利用可能なオプションは次のとおりです。
- バックスラッシュ
(\) - 一重見積もり
(')
例 escape-character-examples
書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。
- 戻るスラッシュ
(\)が選択された出力の例:"Test,\"John\",LastName" - 一重引用符
(')が選択された出力の例:"Test,'"John'",LastName"
空の値出力 empty-value-output
このコントロールを使用して、空の値の文字列表現を設定します。 このオプションは、書き出されたCSV ファイルで空の値がどのように表示されるかを指定します。 利用可能なオプションは次のとおりです。
- Null (null)
- 二重引用符(")の空文字列
- 空の文字列
例 empty-value-examples
書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。
- nullが選択された出力の例:
male,NULL,TestLastName。 この場合、Experience Platformは空の値をnull値に変換します。 - ""が選択された出力例:
male,"",TestLastName。 この場合、Experience Platformは、空の値を二重引用符のペアに変換します。 - 空の文字列が選択された出力例:
male,,TestLastName。 この場合、Experience Platformは空の値を保持し、そのまま(二重引用符なしで)書き出します。
Null 値出力 null-value-output
このコントロールを使用して、書き出されたファイル内の null 値の文字列表現を設定します。 このオプションは、書き出されたCSV ファイルでnull値がどのように表示されるかを決定します。 利用可能なオプションは次のとおりです。
- Null (null)
- 二重引用符(")の空文字列
- 空の文字列
例 null-value-examples
書き出されたCSV ファイルのコンテンツの例と、UIの各選択の例を以下に示します。
- nullが選択された出力の例:
male,NULL,TestLastName。 この場合、変換は行われず、CSV ファイルにはnull値が含まれます。 - ""が選択された出力例:
male,"",TestLastName。 この場合、Experience Platformは、空の文字列の周囲に二重引用符で囲まれたnull値を置き換えます。 - 空の文字列が選択された出力例:
male,,TestLastName。 この場合、Experience Platformはnull値を空の文字列(二重引用符なし)に置き換えます。
圧縮形式 compression-format
データをファイルに保存する際に使用する圧縮タイプを設定します。 GZIP と NONE がサポートされています。 このオプションは、圧縮ファイルを書き出すかどうかを決定します。
エンコード encoding
UI のスクリーンショットには表示されません。 保存した CSV ファイルのエンコーディング(文字セット)を指定します。 オプションは UTF-8 または UTF-16 です。
引用符をエスケープする文字 char-to-escape-quote
UI のスクリーンショットには表示されません。 引用符を含む値を、常に引用符で囲む必要があるかどうかを示すフラグ。
デフォルトでは、引用符文字を含むすべての値をエスケープします。
行区切り記号 line-separator
UI のスクリーンショットには表示されません。 書き込みに使用する行区切り記号を定義します。 最大長は 1 文字です。
先頭の空白を無視 ignore-leading-whitespace
UI のスクリーンショットには表示されません。 書き出される値の先頭の空白をスキップするかどうかを示すフラグ。
Trueが選択された出力の例: "male","John","TestLastName"
Falseが選択された出力の例:" male","John","TestLastName"
末尾の空白を無視 ignore-trailing-whitespace
UI のスクリーンショットには表示されません。 書き出す値の末尾の空白をスキップするかどうかを示すフラグ。
Trueが選択された出力の例: "male","John","TestLastName"
Falseが選択された出力の例:"male ","John","TestLastName"
次の手順 next-steps
このドキュメントでは、CSV データファイルのファイル書き出しオプションを設定し、ダウンストリームのファイル受信システムの要件に合わせてファイルの内容を調整する方法を確認しました。 次に、ファイルベースの宛先のアクティベーションのチュートリアルを読んで、目的のクラウドストレージの場所へのファイルの書き出しを開始します。