---
title: Google Sheets
description: Google Sheetsを接続して同期の動作を把握し、書き込まれるすべてのテーブルと列をクエリします。
species: reference
---
# Google Sheets

Google OAuth と、選択した 1 つ以上のスプレッドシートを使って Google Sheets を接続します。このソースは表示されている各シートタブからテーブルを 1 つ検出し、`titan.google_sheets` に書き込みます。
## Google Sheetsを接続する

1. **アプリ**を開き、**アプリを接続**を選択してから、**Google Sheets**を選択します。
2. Google OAuth の認証情報を入力し、1 つ以上のスプレッドシートを選択します。
3. テーブルを確認してからソースを保存します。
4. 初回の実行が完了するまで**同期履歴**を確認します。

認証情報はシークレットとして保存されます。レイクの列になったり、クエリ結果に表示されたりすることはありません。

## 同期の動作

Supernova は 100 行から型を推論し、結合セルを前の値で補完します。また、行を明確に識別できるように _sn_row_number を追加します。

新しいソースは接続時に同期し、その後はスケジュールに従います。デフォルトの繰り返し間隔は 4 時間です。実行が中断しても、完了した進捗を保持して安全に再試行します。

すべてのレイクのテーブルには[システム列](/docs/concepts/your-lake#システム列) `_synced_at` と `_deleted` もあります。以下の列リファレンスにはソースの列のみを記載しています。

## テーブルリファレンス

Supernova は接続したアカウントからこのリファレンスの情報を検出します。設定後、スプレッドシートのタイトル、シートタブ、ヘッダー、推論した型によってリファレンスが定まります。

初回の検出が完了したら、**アプリ → Google Sheets → テーブル**を開き、すべての正確なテーブル名、列名、型、同期対象を確認します。アカウントを接続するまでは、動的なフィールドを正確に一覧化できません。

## 削除と履歴

行はソースのキーでマージされます。ソース側で行の削除を確認できた場合、Supernova は行を残して `_deleted` を設定します。クエリで履歴を含めるかどうかを選べます。現在の状態だけを取得するには `where not _deleted` で絞り込んでください。