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

重要

Adobe Experience Platform の​ファイル形式オプション​機能は、現在ベータ版です。 ドキュメントと機能は変更される場合があります。
この機能に対するアクセス権については、アドビ担当者にお問い合わせください。

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

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

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

ファイル形式設定 CSV ファイルの場合

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

重要

接続先には、これらのオプションの一部が使用できない場合があります。 宛先でサポートするファイル形式オプションは、宛先の開発者が決定します。 宛先の開発者は、宛先に接続する際に使用できるオプションを決定できます。 必須オプションは、Experience Platform UI でアスタリスクでマークされます。

新しいクラウドストレージの宛先 — （ベータ版）Amazon S3, （ベータ版）Azure Blob, （ベータ版）Azure Data Lake Storage Gen2, （ベータ版）データランディングゾーン, （ベータ版）Google Cloud Storage, （ベータ版）SFTP ：現在、以下で強調表示されている 6 つの CSV オプションのみをサポートしています。

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

区切り

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

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

例

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

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

引用符文字

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

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

例

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

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

エスケープ文字

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

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

例

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

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

空の値出力

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

  • null
  • ""
  • 空の文字列

例

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

  • を使用した出力の例 null 選択済み： male,NULL,TestLastName. この場合、Experience Platformは空の値を null 値に変換します。
  • を使用した出力の例 “” 選択済み： male,"",TestLastName. この場合、Experience Platformは空の値を二重引用符の対に変換します。
  • を使用した出力の例 空の文字列 選択済み： male,,TestLastName. この場合、Experience Platformは空の値をそのまま維持し、（二重引用符なしで）そのまま書き出します。
ヒント

空の値出力と以下のセクションでの null 値出力の違いは、空の値には実際の空の値が含まれるということです。 NULL 値には値がまったくありません。 空の値はテーブル上の空のガラスと考え、null 値はテーブル上にガラスがまったくないと考えます。

Null 値出力

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

  • null
  • ""
  • 空の文字列

例

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

  • を使用した出力の例 null 選択済み： male,NULL,TestLastName. この場合、変換はおこなわれず、CSV ファイルに null 値が含まれます。
  • を使用した出力の例 “” 選択済み： male,"",TestLastName. この場合、Experience Platformは、空の文字列を囲む二重引用符で Null 値を置き換えます。
  • を使用した出力の例 空の文字列 選択済み： male,,TestLastName. この場合、Experience Platformは、null 値を（二重引用符なしで）空の文字列に置き換えます。

圧縮形式

データをファイルに保存する際に使用する圧縮タイプを設定します。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"

次の手順

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

このページ