# Mailpublisher Connector Via CLI

必要に応じて、[Treasure Data CLI](https://docs.treasuredata.com/articles/project-product-documentation/treasure-workflow+Quick+Start+using+TD+Toolbelt+in+a+CLI)を使用してコネクタを使用できます。

ターミナルを開き、次のコマンドを実行して最新の[TD Toolbelt](https://toolbelt.treasuredata.com/)をインストールします。

## 設定ファイルの作成

設定ファイルには、統合からコネクタに入力されるものを指定する in: セクションと、コネクタが Treasure Data のデータベースに出力するものを指定する out: セクションが含まれます。

次の例に示すように、設定ファイル（例: config.yml）を準備します。統合アカウントのアクセス情報を提供してください。

### 例 (config.yml)


```yaml
in:
  type: mail_publisher_smart
  site_id: mysite
  login_id: foo
  password: bar
  data_type: list_status
  file_ids: [1,2,3]
filters:
- type: add_time
  from_value:
    mode: upload_time
  to_column:
    name: time
out: type: td
```

### 認証

**site_id**、**login_id**、および**password**を指定します。認証情報は MailPublisher のコンソールから取得できます。

### データタイプ

#### Email List Status

**data_type**に**list_status**を設定し、ファイル ID のリストとして**file_ids**を指定します。

#### Article Status and Click Count Status

**data_type**に**article_status**または**click_count_list**を設定し、**start_date**と**duration**を指定します。増分読み込みを行いたい場合は**incremental**を設定します。


```yaml
in:
  type: mail_publisher_smart
  data_type: article_status
  # data_type: click_count_list
  start_date: 2018-10-01
  duration: 1
  incremental: true
```

## (オプション) プレビュー

td connector:preview コマンドを実行して、設定ファイルを検証します。


```
$ td connector:preview config.yml
```

### データパーティションキー

コネクタセッションでは、データパーティションキーとして使用するために、結果データに少なくとも1つのタイムスタンプ列が必要であり、デフォルトでは最初のタイムスタンプ列がキーとして選択されます。MailPublisher コネクタの結果スキーマにはタイムスタンプ列がないため、次のようにフィルター設定を追加して「**time**」列を追加します。


```yaml
in:
  type: mail_publisher_smart
  ...
filters:
- type: add_time
  from_value:
    mode: upload_time
  to_column:
    name: time
out:
  type: td
```

## 新しいコネクタセッションの作成

td connector:create を実行します。

次のコマンドを使用すると、MailPublisher コネクタを使用した日次インポートセッションが作成されます。


```bash
$ td connector:create daily_mail_publisher_import \
    "10 0 * * *" td_sample_db td_sample_table config.yml
```