# Google Sheets Import Integration

このインテグレーションを使用すると、Google Sheetsからデータをインポートできます。

このトピックには以下が含まれます:

## 前提条件

- Treasure Dataの基本知識
- Googleアカウント(Google Drive用)
- 認可されたTreasure Dataアカウントアクセス


## Treasure Data Integration の静的 IP アドレス

セキュリティポリシーで IP ホワイトリストが必要な場合は、接続を成功させるために Treasure Data の IP アドレスを許可リストに追加する必要があります。

リージョンごとに整理された静的 IP アドレスの完全なリストは、次のリンクにあります:
[https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/](https://api-docs.treasuredata.com/en/overview/ip-addresses-integrations-result-workers/)

## TD Console経由でGoogle Sheetsからインポート

### 新しい接続の作成

データ接続を設定する際、インテグレーションにアクセスするための認証情報を提供します。Treasure Dataでは、認証を設定してから、ソース情報を指定します。

1. **TD Console**を開きます。
2. **Integrations Hub** > **Catalog**に移動します。
3. Google Sheetsを検索して選択します。
![](/assets/image-20200714-191234.8e3b45a96e184ca108805c3c05eecd9f52dcbac1d62a5f10a58c9fc48051d60a.af95bf87.png)
4. 以下のダイアログが開きます。
![](/assets/google-sheets-import-integration-2024-07-09-1.28eb39c623cfed0615d6c90479ec719963e7726b6ebe15288f1baa946872d031.af95bf87.png)
5. 既存のOAuth接続を選択するか、新しい接続を作成して、接続を認証します。
![](/assets/google-sheets-import-integration-2024-02-16-1.3738eafb930d43a6d9e6941f2ad069bd46ec763d2b8507adb0e8d86750046afa.af95bf87.png)
6. 新しいGoogle Sheets接続に名前を付けます。
![](/assets/image-20200714-191357.6cafe77464510a9057f559ba8de722fa5fbbe900692adf4b99ce01512f547f43.af95bf87.png)


### アカウント認証

Treasure Data Google Sheetsインテグレーションへのアクセスには、OAuth2認証が必要です。この認証では、ユーザーは手動でTreasure Dataアカウントを各自のGoogleアカウントに接続する必要があります。

既存の接続がない場合は、新しい認証を作成します。

1. 認証ダイアログを開いた後、「OAuth connection」の下にあるリンクを選択して、新しい接続を作成します
2. ポップアップウィンドウでGoogle Sheetsアカウントにログインし、Treasure Dataアプリへのアクセスを許可します。
![](/assets/google-sheets-import-integration-2024-02-16-3.571cee3a817048d15bbdde0694ffb98509978e989f997e61df0370d629604c09.af95bf87.png)
3. インテグレーションダイアログペインにリダイレクトされます。Google Sheetsを選択し、ドロップダウンメニューから新しい接続を選択します。
![](/assets/image-20200714-191541.266ebc67b2cc0fe903ea58bca3f21708ca464d6e3f8d435f2f14a61effccfec9.af95bf87.png)


### ソースの作成

認証された接続を作成すると、自動的にAuthenticationsに移動します。

1. 作成した接続を検索します。
![](/assets/image-20200714-191606.086bde3067c5d2a453b21aac44d2ca59ad78bacf6bbd28001510906f734ecf39.af95bf87.png)
2. **New Source**を選択します。
3. Data Transferフィールドに**Source**の名前を入力します。
4. **Next**をクリックします。
![](/assets/image-20200714-191642.2259861ad196cbbb4458b05840a1262dbad90d9aa8e369eb61b0057d88bdb866.af95bf87.png)


### ソーステーブルの指定

1. 以下のパラメータを編集します
![image-20200930-050110.png](/assets/image-20200714-191722.18fd9514e7c4952cc5d459060168cab95207ab20d6a7113182964ada92f9f9f7.af95bf87.png)


| **パラメータ** | **説明** |
|  --- | --- |
| Spreadsheet Key | Google Spreadsheetのキーを指定 |
| Worksheet Title | TDにインポート後のワークシートのタイトル |
| Range to fetch | Google Spreadsheetからデータを取得する範囲  ワークシートタイトルなしでA1表記を使用します(例: A1:C100)。取得範囲を指定する場合は、その範囲内にデータがあることを確認してください。空の場合は、シート全体を取り込み、列数は最初の行/列によって定義されます。 |
| Use first row/column as header | 最初の行または列をヘッダーとして保持する場合に選択します。 |
| Skip first rows/columns | Rows dimensionを使用する場合は上位n行をスキップし、Column dimensionを使用する場合は左側のn列をスキップします |
| Major Dimension | RowsまたはColumnsを選択 |
| Value Render Option | Formatted valueまたはUnformatted value |
| Date Time Render Option | Formatted StringまたはSerial Number  Value RenderでFormatted Valueを使用している場合は無視されます |


### データ設定の定義

1. **Next**をクリックします。
データ設定ページが開きます。
2. 必要に応じてデータ設定を編集するか、このダイアログページをスキップします。


### Data Preview

インポートを実行する前に、Generate Preview を選択してデータの[プレビュー](/products/customer-data-platform/integration-hub/batch/import/previewing-your-source-data)を表示できます。Data preview はオプションであり、選択した場合はダイアログの次のページに安全にスキップできます。

1. **Next** を選択します。Data Preview ページが開きます。
2. データをプレビューする場合は、**Generate Preview** を選択します。
3. データを確認します。


### Data Placement

データの配置について、データを配置したいターゲット database と table を選択し、インポートを実行する頻度を指定します。

1. **Next** を選択します。Storage の下で、インポートされたデータを配置する新しい database を作成するか、既存の database を選択し、新しい table を作成するか、既存の table を選択します。
2. **Database** を選択 > **Select an existing** または **Create New Database** を選択します。
3. オプションで、database 名を入力します。
4. **Table** を選択 > **Select an existing** または **Create New Table** を選択します。
5. オプションで、table 名を入力します。
6. データをインポートする方法を選択します。
  - **Append** (デフォルト) - データインポートの結果は table に追加されます。
table が存在しない場合は作成されます。
  - **Always Replace** - 既存の table の全体の内容をクエリの結果出力で置き換えます。table が存在しない場合は、新しい table が作成されます。
  - **Replace on New Data** - 新しいデータがある場合のみ、既存の table の全体の内容をクエリの結果出力で置き換えます。
7. **Timestamp-based Partition Key** 列を選択します。
デフォルトキーとは異なるパーティションキーシードを設定したい場合は、long または timestamp 列をパーティショニング時刻として指定できます。デフォルトの時刻列として、add_time フィルターで upload_time を使用します。
8. データストレージの **Timezone** を選択します。
9. **Schedule** の下で、このクエリを実行するタイミングと頻度を選択できます。


#### 一度だけ実行

1. **Off** を選択します。
2. **Scheduling Timezone** を選択します。
3. **Create & Run Now** を選択します。


#### 定期的に繰り返す

1. **On** を選択します。
2. **Schedule** を選択します。UI では、*@hourly*、*@daily*、*@monthly*、またはカスタム *cron* の 4 つのオプションが提供されます。
3. **Delay Transfer** を選択して、実行時間の遅延を追加することもできます。
4. **Scheduling Timezone** を選択します。
5. **Create & Run Now** を選択します。


転送が実行された後、**Data Workbench** > **Databases** で転送の結果を確認できます。