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

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

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

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

ファイル形式設定 (CSV ファイルの場合) file-configuration

ファイル形式設定オプションを表示するには、 宛先に接続 ワークフロー。 選択 データタイプ:セグメント および ファイルタイプ:CSV 書き出したファイルのフォーマット設定を表示するには CSV ファイル。

IMPORTANT
接続先には、これらのオプションの一部が使用できない場合があります。 宛先でサポートするファイル形式オプションは、宛先の開発者が決定します。 宛先の開発者は、宛先に接続する際に使用できるオプションを決定できます。 必須オプションは、Experience Platform UI でアスタリスクでマークされます。
Adobeが構築したクラウドストレージの宛先 — Amazon S3, Azure Blob, Azure Data Lake Storage Gen2, データランディングゾーン, Google Cloud Storage, SFTP :現在、以下で強調表示されている 6 つの CSV オプションのみをサポートしています。

使用可能なファイル形式オプションの一部を示す画像。

区切り delimiter

このコントロールを使用して、書き出された CSV ファイルの各フィールドと値の区切り文字を設定します。 利用可能なオプションは次のとおりです。

  • コロン (:)
  • コンマ (,)
  • パイプ (|)
  • セミコロン (;)
  • Tab (\t)

UI の各選択項目と共に、書き出された CSV ファイルのコンテンツの以下の例を参照してください。

  • を使用した出力の例 コロン(:) 選択済み: male:John:Doe
  • を使用した出力の例 コンマ(,) 選択済み: male,John,Doe
  • を使用した出力の例 パイプ(|) 選択済み: male|John|Doe
  • を使用した出力の例 セミコロン(;) 選択済み: male;John;Doe
  • を使用した出力の例 タブ(\t) 選択済み: male \t John \t Doe

引用符文字 quote-character

書き出した文字列から二重引用符を削除する場合は、このオプションを使用します。利用可能なオプションは次のとおりです。

  • Null 文字 (\0000). 書き出した CSV ファイルから二重引用符を削除するには、このオプションを使用します。
  • 二重引用符 ("). 書き出した CSV ファイルで二重引用符を保持するには、このオプションを使用します。

UI の各選択項目と共に、書き出された CSV ファイルのコンテンツの以下の例を参照してください。

  • を使用した出力の例 Null 文字 (\0000) 選択済み: Test,John,LastName
  • を使用した出力の例 二重引用符 (") 選択済み: "Test","John","LastName"

エスケープ文字 escape-character

既に引用符で囲まれた値内の引用符をエスケープするための 1 文字を設定するには、このオプションを使用します。 例えば、このオプションは、文字列の一部が既に二重引用符で囲まれている二重引用符で囲まれた文字列がある場合に便利です。 このオプションは、内側の二重引用符を置き換える文字を決定します。 利用可能なオプションは次のとおりです。

  • バックスラッシュ (\)
  • 一重引用符 (')

UI の各選択項目と共に、書き出された CSV ファイルのコンテンツの以下の例を参照してください。

  • を使用した出力の例 バックスラッシュ(\) 選択済み: "Test,\"John\",LastName"
  • を使用した出力の例 一重引用符(') 選択済み: "Test,'"John'",LastName"

空の値出力 empty-value-output

空の値の文字列表現を設定するには、このコントロールを使用します。 このオプションは、書き出した CSV ファイルで空の値をどのように表すかを決定します。 利用可能なオプションは次のとおりです。

  • Null (null)
  • 二重引用符で囲まれた空の文字列 ("")
  • 空の文字列

UI の各選択項目と共に、書き出された CSV ファイルのコンテンツの以下の例を参照してください。

  • を使用した出力の例 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 (null)
  • 二重引用符で囲まれた空の文字列 ("")
  • 空の文字列

UI の各選択項目と共に、書き出された CSV ファイルのコンテンツの以下の例を参照してください。

  • を使用した出力の例 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