# Box Export Integration

[Box Import Integrationについて詳しくはこちらをご覧ください。](/ja/int/box-import-integration)

Treasure Dataのジョブ結果をBoxアカウントに直接エクスポートします。

以下のトピックに進んでください:

前提条件

- Treasure Dataの基本知識
- Boxクラウドストレージアカウント


# Treasure コンソールを使用して接続を作成する

Treasure コンソールを使用して接続を設定できます。

## Boxアカウントとの接続を設定する

1. **Treasure コンソール**を開きます。
2. **Integrations Hub > Catalog**に移動します。
3. Catalogページの右端にある検索アイコンをクリックし、**Box**と入力します。
4. Boxコネクタにカーソルを合わせて**Create Authentication**を選択します。![](/assets/box.504c996c6e5e04a8cd4fe277d5dac801f853528db614581055d3a60c29328e41.0c422bf5.png)
5. OAuthトークンを入力するか、**Click here**を選択してBoxとの接続を認証します。


![](/assets/create_new_connection.18e52df4d747e34ad9478419c5ee33abd8453bb725c786059c83343086879e0c.0c422bf5.png)

まだログインしていない場合はBoxにログインするためにリダイレクトされ、ログイン済みの場合はTreasure DataにBoxアカウントへのアクセスを許可する同意ページにリダイレクトされます。

ドメイン[https://console.treasuredata.com](https://console.treasuredata.com/)の場合、次のように表示されます:

![](/assets/mceclip0.5d9fd19b922965e4943218806404f8ee010e13fb7334fe810598b45884c7e266.0c422bf5.png)

[https://console.treasuredata.co.jp](https://console.treasuredata.co.jp/)の場合

![](/assets/mceclip1.6e6f42de60b14fa5347f2a7ed87c2893287103d5e9a0a22c8a49fd83820bc0c7.0c422bf5.png)

**Grant access to Box**を選択すると、Treasure Dataの接続画面にリダイレクトされます。

再度Boxコネクタを選択し、OAuth接続フィールドに移動します。ドロップダウンリストにアカウント名が表示されたOAuth接続が表示されます。

使用するアカウントを選択し、接続の作成に進みます。

![](/assets/oauth_created.1675cbf114220075c935db6fd650ac575941db99062ea20aa4152bcc29b0d13b.0c422bf5.png)

**Continue**を選択して詳細ビューに進みます。

![](/assets/2018-10-16_1241.0be2431abf4a0527a386768400d2ce3a12b08c698d6ee6e86f31ae284b525fb3.0c422bf5.png)

接続の名前を入力し、**Done**を選択して完了します。

OAuth(唯一の認証方式)は、treasuredata.comとそのサブドメインでのみサポートされています。

## データ接続への出力結果を設定する

この手順では、クエリを作成または再利用します。クエリ内で、データ接続を設定します。

Treasure コンソールのクエリエディタページに移動します。

データのエクスポートに使用する予定のクエリにアクセスします。

必要に応じてクエリをコンパイルします。

クエリをコンパイルします(必要な場合)。

## 結果エクスポート先の指定

**Export** **Results** を選択します。

検索ボックスに接続名を入力してフィルタリングし、Boxの接続を選択します。

すべての情報を編集します。

![](/assets/screenshot-2025-06-26-at-10.02.20.495f9cea162e86325ed0abb9d912ce9dd282fb6139cbcf698a1bc96be3ef691a.0c422bf5.png)

パラメータを指定します:

- **Export To**(必須)利用可能なオプション:
  - Existing File. 選択した場合、File IDを指定する必要があります。
  - New File. 選択した場合、File NameとFolder IDを指定する必要があります。
- **File Name** 拡張子を除いたエクスポートされるファイル名。例: `Result_1810212`
- **Folder ID** エクスポートされたファイルを保存するBoxのフォルダ。
- **File ID** 既存のBox File ID。
- **Format** 結果ファイルのフォーマットを指定: CSVまたはTSV
- **Encoders** 結果を圧縮するかどうかを指定します。利用可能なオプション: None、gz、bzip2、暗号化PGP
- **Public Key** ファイルをアップロードする前に暗号化するために使用される公開鍵
- **Key Identifier** ファイルを保護するために使用される暗号化サブキーのKey IDを指定します。マスターキーは暗号化プロセスから除外されます。
- **Amor** ASCII armorを使用するかどうか
- **Compression Type**
  - ファイルの圧縮に使用される圧縮アルゴリズムを定義します。ファイルは暗号化される前に圧縮され、Boxサーバーにアップロードされます。
  - **注意: ファイルを暗号化してアップロードする前に圧縮してください。復号化すると、ファイルは.gzや.bz2などの圧縮形式に戻ります。**
- **Header line** 選択した場合、エクスポートされたデータにはヘッダー行としてカラム名が含まれます。
- **Null String** NULL値を表すために使用される値。利用可能なオプション:
  - Default. 選択した場合、CSVファイルフォーマットではNULL値を表すために空の文字列 **''** が使用され、TSVフォーマットでは\Nが使用されます。
  - Empty string
  - \N NULL
  - null
- **End-of-line character** 行末の文字。利用可能なオプション: CRLF、LF、CR
- **Quote Policy** 利用可能なオプション:
  - ALL. 選択した場合、すべての値がダブルクォート("")で囲まれます。
  - MINIMAL. 選択した場合、埋め込まれたクォート(")を含む値は、連続する2つのクォート("")で表されます。MINIMALクォートポリシーはCSVに適用されます
  - NONE. 選択した場合、埋め込まれたクォートに対するエスケープは適用されません。デフォルトでは、NONEはTSVファイルフォーマットに適用されます
- **Max Retries** Boxサーバーエラーまたはネットワークエラーによりエラーが発生した場合、アップロードを中止する前に試行される再試行回数。
- **Retry Timeout** 再試行の上限時間(秒単位)。


## クエリの実行

クエリに名前を付けて保存して実行するか、単にクエリを実行します。

クエリが正常に実行されると、クエリ結果は自動的に指定されたContainerの宛先にインポートされます。

## Audience Studio で Segment をアクティベートする

Audience Studio で activation を作成することで、segment データをターゲットプラットフォームに送信することもできます。

1. **Audience Studio** に移動します。
2. parent segment を選択します。
3. ターゲット segment を開き、右クリックして、**Create Activation** を選択します。
4. **Details** パネルで、Activation 名を入力し、前述の Configuration Parameters のセクションに従って activation を設定します。
5. **Output Mapping** パネルで activation 出力をカスタマイズします。


![](/assets/ouput.b2c7f1d909c4f98ed10f5300df858a4b19f71a3b0834df952f5fb24018a5ea78.8ebdf569.png)

- Attribute Columns
  - **Export All Columns** を選択すると、変更を加えずにすべての列をエクスポートできます。
  - **+ Add Columns** を選択して、エクスポート用の特定の列を追加します。Output Column Name には、Source 列名と同じ名前があらかじめ入力されます。Output Column Name を更新できます。**+ Add Columns** を選択し続けて、activation 出力用の新しい列を追加します。
- String Builder
  - **+ Add string** を選択して、エクスポート用の文字列を作成します。次の値から選択します:
    - String: 任意の値を選択します。テキストを使用してカスタム値を作成します。
    - Timestamp: エクスポートの日時。
    - Segment Id: segment ID 番号。
    - Segment Name: segment 名。
    - Audience Id: parent segment 番号。


1. **Schedule** を設定します。


![](/assets/snippet-output-connector-on-audience-studio-2024-08-28.a99525173709da1eb537f839019fa7876ffae95045154c8f2941b030022f792c.8ebdf569.png)

- スケジュールを定義する値を選択し、オプションでメール通知を含めます。


1. **Create** を選択します。


batch journey の activation を作成する必要がある場合は、[Creating a Batch Journey Activation](/products/customer-data-platform/journey-orchestration/batch/creating-a-batch-journey-activation) を参照してください。

# よくある質問

### 最終結果に(バックスラッシュ)文字が含まれているのはなぜですか?

CSVファイル内のデータ(値)にクォート(")が含まれている場合、またはTSVファイル内にタブが含まれている場合で、Quote PolicyがNONEに設定されている場合、文字が誤ってデータをエスケープし、問題が発生する可能性があります。これを解決するには、Quote PolicyをMINIMALまたはALLに設定してみてください。