コネクテッドシート

コネクテッドシートを使用すると、Google スプレッドシート内でペタバイト単位のデータを直接分析できます。スプレッドシートを BigQuery データウェアハウスまたはLookerに接続し、使い慣れたスプレッドシートのツール（ピボットテーブル、グラフ、数式など）を使用して分析できます。

BigQuery データソースを管理する

このセクションでは、BigQuery Shakespeare の一般公開データセットを使用して、コネクテッドシートの使用方法を説明します。このデータセットには次の情報が含まれています。

フィールド	タイプ	説明
word	`STRING`	コーパスから抽出された一意の単語（空白文字が区切り文字）。
word_count	`INTEGER`	この単語がこのコーパスに出現する回数。
corpus	`STRING`	この単語が抽出された作品。
corpus_date	`INTEGER`	このコーパスが公開された年。

アプリケーションが BigQuery コネクテッドシートのデータをリクエストする場合は、通常の Google Sheets API リクエストに必要な他のスコープに加えて、bigquery.readonly スコープを付与する OAuth 2.0 トークンを提供する必要があります。詳細については、Google Sheets API のスコープを選択するをご覧ください。

データソースは、データが見つかる外部ロケーションを指定します。データソースはスプレッドシートに接続されます。

BigQuery データソースを追加する

データソースを追加するには、 AddDataSourceRequest を使用して spreadsheets.batchUpdate メソッドを指定します。リクエストの本文では、dataSource フィールドをタイプ DataSource オブジェクトとして指定する必要があります。

"addDataSource":{
   "dataSource":{
      "spec":{
         "bigQuery":{
            "projectId":"PROJECT_ID",
            "tableSpec":{
               "tableProjectId":"bigquery-public-data",
               "datasetId":"samples",
               "tableId":"shakespeare"
            }
         }
      }
   }
}

PROJECT_ID は、有効な Google Cloud プロジェクト ID に置き換えます。

データソースが作成されると、関連する DATA_SOURCE シートが作成され、最大 500 行のプレビューが表示されます。プレビューはすぐには使用できません。BigQuery データをインポートするために、実行が非同期でトリガーされます。

AddDataSourceResponse には次のフィールドが含まれます。

dataSource: 作成された DataSource オブジェクト。 dataSourceId は、スプレッドシートスコープの一意の ID です。データソースから各 DataSource オブジェクトを作成するために、入力され、参照されます。
dataExecutionStatus: BigQuery データをプレビューシートにインポートする実行のステータス。詳細については、データの実行ステータスをご覧ください。

BigQuery データソースを更新または削除する

spreadsheets.batchUpdate メソッドを使用し、 UpdateDataSourceRequest リクエストまたは DeleteDataSourceRequest リクエストを適宜指定します。

BigQuery データソースオブジェクトを管理する

データソースがスプレッドシートに追加されると、データソースオブジェクトを作成できます。データソースオブジェクトは、ピボットテーブル、グラフ、数式などの通常の Sheets ツールで、コネクテッドシートと統合してデータ分析を強化します。

オブジェクトには次の 4 種類があります。

DataSource テーブル
DataSource pivotTable
DataSource グラフ
DataSource 数式

BigQuery データソーステーブルを追加する

スプレッドシートエディタでは「抽出」と呼ばれます。テーブルオブジェクトは、データソースから Sheets にデータの静的ダンプをインポートします。ピボットテーブルと同様に、テーブルは指定され、左上のセルに固定されます。

次のコードサンプルは、 spreadsheets.batchUpdate メソッドと UpdateCellsRequest を使用して、2 列（word と word_count）の最大 1,000 行のデータソーステーブルを作成する方法を示しています。

"updateCells":{
   "rows":{
      "values":[
         {
            "dataSourceTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "columns":[
                  {
                     "name":"word"
                  },
                  {
                     "name":"word_count"
                  }
               ],
               "rowLimit":{
                  "value":1000
               },
               "columnSelectionType":"SELECTED"
            }
         }
      ]
   },
   "fields":"dataSourceTable"
}

DATA_SOURCE_ID は、データソースを識別するスプレッドシートスコープの一意の ID に置き換えます。

データソーステーブルが作成されても、データはすぐには使用できません。スプレッドシートエディタでは、プレビューとして表示されます。BigQuery データを取得するには、データソーステーブルを更新する必要があります。同じ batchUpdate 内で RefreshDataSourceRequest を指定できます。すべてのデータソースオブジェクトは同様に機能します。詳細については、データソースオブジェクトを更新するをご覧ください。

更新が完了して BigQuery データが取得されると、データソーステーブルは次のように入力されます。

シェイクスピアの一般公開データセットのデータを示すデータソーステーブル。

BigQuery データソースピボットテーブルを追加する

従来のピボットテーブルとは異なり、データソースピボットテーブルはデータソースによってバックアップされ、列名でデータを参照します。次のコードサンプルは、spreadsheets.batchUpdate メソッドと UpdateCellsRequest を使用して、コーパス別の単語数の合計を示すピボットテーブルを作成する方法を示しています。

"updateCells":{
   "rows":{
      "values":[
         {
            "pivotTable":{
               "dataSourceId":"DATA_SOURCE_ID",
               "rows":{
                  "dataSourceColumnReference":{
                     "name":"corpus"
                  },
                  "sortOrder":"ASCENDING"
               },
               "values":{
                  "summarizeFunction":"SUM",
                  "dataSourceColumnReference":{
                     "name":"word_count"
                  }
               }
            }
         }
      ]
   },
   "fields":"pivotTable"
    }

DATA_SOURCE_ID は、データソースを識別するスプレッドシートスコープの一意の ID に置き換えます。

BigQuery データが取得されると、データソースピボットテーブルは次のように入力されます。

シェイクスピアの一般公開データセットのデータを示すデータソースのピボットテーブル。

BigQuery データソースグラフを追加する

次のコードサンプルは、spreadsheets.batchUpdate メソッドと AddChartRequest を使用して、chartType が COLUMN のデータソースグラフを作成し、コーパス別の単語数の合計を表示する方法を示しています。

"addChart":{
   "chart":{
      "spec":{
         "title":"Corpus by word count",
         "basicChart":{
            "chartType":"COLUMN",
            "domains":[
               {
                  "domain":{
                     "columnReference":{
                        "name":"corpus"
                     }
                  }
               }
            ],
            "series":[
               {
                  "series":{
                     "columnReference":{
                        "name":"word_count"
                     },
                     "aggregateType":"SUM"
                  }
               }
            ]
         }
      },
      "dataSourceChartProperties":{
         "dataSourceId":"DATA_SOURCE_ID"
      }
   }
}

DATA_SOURCE_ID は、データソースを識別するスプレッドシートスコープの一意の ID に置き換えます。

BigQuery データが取得されると、データソースグラフは次のようにレンダリングされます。

シェイクスピアの一般公開データセットのデータを示すデータソースチャート。

BigQuery データソースの数式を追加する

次のコードサンプルは、spreadsheets.batchUpdate メソッドと UpdateCellsRequest を使用して、単語数の平均を計算するデータソースの数式を作成する方法を示しています。

"updateCells":{
   "rows":[
      {
         "values":[
            {
               "userEnteredValue":{
                  "formulaValue":"=AVERAGE(shakespeare!word_count)"
               }
            }
         ]
      }
   ],
   "fields":"userEnteredValue"
}

BigQuery データが取得されると、データソースの数式は次のように入力されます。

シェイクスピアの一般公開データセットのデータを示すデータソースの数式。

BigQuery データソースオブジェクトを更新する

データソースオブジェクトを更新して、現在のデータソースの仕様とオブジェクト構成に基づいて BigQuery から最新のデータを取得できます。メソッドを使用して RefreshDataSourceRequestを呼び出すことができます。spreadsheets.batchUpdate次に、 DataSourceObjectReferences オブジェクトを使用して、更新するオブジェクト参照を 1 つ以上指定します。

1 つの batchUpdate リクエスト内でデータソースオブジェクトを作成して更新できます。

Looker データソースを管理する

このガイドでは、Looker データソースを追加、更新、削除し、ピボットテーブルを作成して更新する方法について説明します。

Looker コネクテッドシートのデータをリクエストするアプリケーションは、Looker との既存の Google アカウントリンクを再利用します。

Looker データソースを追加する

"addDataSource":{
   "dataSource":{
      "spec":{
         "looker":{
            "instance_uri":"INSTANCE_URI",
            "model":"MODEL",
            "explore":"EXPLORE"
         }
      }
   }
}

INSTANCE_URI、MODEL、 EXPLORE は、有効な Looker インスタンス URI、モデル名、 Explore 名に置き換えます。

データソースが作成されると、関連する DATA_SOURCE シートが作成され、選択した Explore の構造（ビュー、ディメンション、メジャー、フィールドの説明など）のプレビューが表示されます。

AddDataSourceResponse には次のフィールドが含まれます。

dataSource: 作成された DataSource オブジェクト。 dataSourceId は、スプレッドシートスコープの一意の ID です。データソースから各 DataSource オブジェクトを作成するために、入力され、参照されます。
dataExecutionStatus: BigQuery データをプレビューシートにインポートする実行のステータス。詳細については、データの実行ステータスをご覧ください。

Looker データソースを更新または削除する

spreadsheets.batchUpdate メソッドを使用し、 UpdateDataSourceRequest リクエストまたは DeleteDataSourceRequest リクエストを適宜指定します。

Looker データソースオブジェクトを管理する

データソースがスプレッドシートに追加されると、データソースオブジェクトを作成できます。Looker データソースの場合、DataSource ピボットテーブルオブジェクトのみを作成できます。

Looker データソースから DataSource の数式、抽出、グラフを作成することはできません。

Looker データソースオブジェクトを更新する

データソースオブジェクトを更新して、現在のデータソースの仕様とオブジェクト構成に基づいて Looker から最新のデータを取得できます。メソッドを使用して RefreshDataSourceRequestを呼び出すことができます。spreadsheets.batchUpdate次に、 DataSourceObjectReferences オブジェクトを使用して、更新するオブジェクト参照を 1 つ以上指定します。

1 つの batchUpdate リクエスト内でデータソースオブジェクトを作成して更新できます。

データの実行ステータス

データソースを作成するか、データソースオブジェクトを更新すると、BigQuery または Looker からデータを取得し、 DataExecutionStatus を含むレスポンスを返すバックグラウンド実行が作成されます。実行が正常に開始されると、 DataExecutionState は通常、RUNNING状態になります。

このプロセスは非同期であるため、アプリケーションはポーリングモデルを実装して、データソースオブジェクトのステータスを定期的に取得する必要があります。ステータスが SUCCEEDED または FAILED 状態を返すまで、 spreadsheets.get メソッドを使用します。ほとんどの場合、実行はすぐに完了しますが、データソースの複雑さによって異なります。通常、実行時間は 10 分を超えません。

コネクテッド シート コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

BigQuery データソースを管理する

BigQuery データソースを追加する

BigQuery データソースを更新または削除する

BigQuery データソース オブジェクトを管理する

BigQuery データソース テーブルを追加する

BigQuery データソース ピボット テーブルを追加する

BigQuery データソース グラフを追加する

BigQuery データソースの数式を追加する

BigQuery データソース オブジェクトを更新する

Looker データソースを管理する

Looker データソースを追加する

Looker データソースを更新または削除する

Looker データソース オブジェクトを管理する

Looker データソース オブジェクトを更新する

データの実行ステータス

関連トピック

コネクテッドシート

BigQuery データソースオブジェクトを管理する

BigQuery データソーステーブルを追加する

BigQuery データソースピボットテーブルを追加する

BigQuery データソースグラフを追加する

BigQuery データソースオブジェクトを更新する

Looker データソースオブジェクトを管理する

Looker データソースオブジェクトを更新する