ファイルベースの宛先のファイル形式オプションの設定

IMPORTANT
このドキュメントで説明するファイル形式オプションは、現在 CSV ファイルでのみ使用できます。

書き出したファイルに対して様々なファイル形式オプションを設定するオプションは、ファイルベースの宛先(Amazon S3Azure Blob または SFTP など)に接続するときに使用できます。

Experience Platform UI を使用して、書き出したファイルに対して様々なファイル形式オプションを設定できます。 Experience Platform から受け取ったファイルを最適に読み取り、解釈するために、書き出されたファイルのいくつかのプロパティを、ユーザー側のファイル受け取りシステムの要件に合わせて変更することができます。

CSV ファイルのファイル形式設定 file-configuration

ファイル形式オプションを表示するには、 宛先に接続ワークフローを開始します。 データタイプ:セグメント および ファイルタイプ:CSV を選択して、書き出された CSV ファイルで使用できるファイル形式設定を表示します。

IMPORTANT
接続先には、これらのオプションの一部が使用できない場合があります。 宛先でサポートするファイル形式オプションは、宛先の開発者が決定します。 宛先の開発者は、宛先に接続する際に使用できるオプションを決定できます。 必須オプションは、Experience Platform UI でアスタリスクでマークされます。
Adobeが構築したクラウドストレージの宛先(Amazon S3Azure BlobAzure Data Lake Storage Gen2Data Landing ZoneGoogle Cloud StorageSFTP)では、現在、以下にハイライト表示されている 6 つの 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は空の値を保持し、そのまま(二重引用符なしで)書き出します。
TIP
以下の節で示す空の値出力と null 値の出力の違いは、空の値には空の実際の値が含まれることです。 NULL 値には値がありません。 空の値はテーブル上に空のガラスがあり、null 値はテーブルにガラスがまったくない状態と考えてください。

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 データファイルのファイル書き出しオプションを設定し、ダウンストリームのファイル受信システムの要件に合わせてファイルの内容を調整する方法を確認しました。 次に、ファイルベースの宛先のアクティベーションのチュートリアルを読んで、目的のクラウドストレージの場所へのファイルの書き出しを開始します。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6