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