Google Sheetsをデータパイプラインソースとして設定する ​

Google Sheetsをデータパイプラインソースとして設定し、スプレッドシートデータを送信先に抽出します。 選択した各シート（タブ）は独自のテーブルとして同期されるため、アドホックスプレッドシートのデータをデータウェアハウスに移動できます。

このガイドでは、コネクションの設定、パイプラインの構成、オブジェクトの同期方法、同期動作、スキーマとデータ型の処理、既知の制限について説明します。

サポートされている機能 ​

Google Sheetsをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続: GoogleのグローバルAPIを通じて、HTTPS経由でGoogle Sheetsに接続します。 オンプレミスエージェントは不要です。
• フルリフレッシュ同期: スケジュールされた実行ごとに、選択したすべてのシートの完全な内容を読み取ります。 Google Sheetsは行レベルの変更タイムスタンプを公開しないため、増分同期はサポートされません。 詳細については、同期モードを参照してください。
• オブジェクトレベルの選択: 同期する個別のシートタブを選択します。 各タブは、送信先の個別のテーブルとして同期されます。
• 主キーに基づくアップサートまたは完全上書き: オブジェクトに主キーを設定して行をアップサートし、削除を追跡するか、主キーを未設定のままにして同期ごとに送信先テーブルを上書きします。 詳細については、同期モードを参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護: 機密フィールドをそのままレプリケートするか、宛先に到達する前にハッシュ化します。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。

前提条件 ​

Google Sheetsをデータパイプラインソースとして接続する前に、次の要件を満たしてください。

• 同期するスプレッドシートへのアクセス権を持つGoogleアカウントまたはGoogle Cloud Platform（GCP）サービスアカウント
• 選択した認証方法の認証情報:
  • OAuth 2.0: GoogleのOAuth同意フローを完了できるGoogleユーザーアカウント。
  • サービスアカウント: GCPサービスアカウントのメールアドレスと秘密鍵。

サポートされるコネクションタイプ ​

Google Sheetsデータパイプラインは、次の2つの認証方法をサポートしています。

• OAuth 2.0: GoogleのOAuth同意画面を通じて、Googleユーザーアカウントを使用して接続します。 Workatoでは、個人ユーザーまたはチームにこの方法を推奨しています。
• サービスアカウント: GCPサービスアカウントのメールアドレスと秘密鍵を使用して接続します。 Workatoでは、自動化された非対話型パイプラインにこの方法を推奨しています。 同期する各スプレッドシートで、サービスアカウントが明示的に共有されている必要があります。

Google Sheetsに接続する ​

Google Sheetsをデータパイプラインソースとして接続するには、次の手順を完了します。

パイプラインの設定 ​

Google Sheetsをデータパイプラインソースとして設定するには、次の手順を完了します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

オブジェクトの同期方法 ​

各Google Sheetsオブジェクトは、スプレッドシート内の1つのシート（タブ）に対応します。 Workatoは先頭行からシートのスキーマを検出し、そのシートを送信先の独自のテーブルに同期します。 Workatoは、固定されたオブジェクトカタログに依存するのではなく、各コネクションに対してこのスキーマを検出して再構築します。

Workatoは、行と列で構成される標準シートであるグリッド型シートのみを同期します。 グラフシートとオブジェクトシート（埋め込み図形またはフォーム）はサポートされません。

オブジェクトとして選択した後にシートタブの名前を変更しても、Workatoは内部的にそのタブの追跡と同期を継続します。 タブを削除した場合、オブジェクトを削除または再設定するまで同期は失敗します。

ヘッダー行、空白のヘッダー、空の行 ​

Workatoはシートを読み取るときに次のルールを適用します。

• ヘッダーセルが空白、または空白文字のみを含む列は同期から除外されます。 列を意図的にパイプラインから非表示にするには、空白のヘッダーを使用します。
• シートに同じヘッダー値を持つ列が2つ以上ある場合、Workatoは列の文字を付加して列を区別します。 たとえば、C列とG列にどちらもScoreという名前の列がある場合、Score_CおよびScore_Gとして同期されます。
• すべてのセルが空の行は送信先から除外されます。 Workatoは空の行をnull値のレコードとして保持しません。

同期モード ​

Google Sheetsデータパイプラインはフルリフレッシュ同期のみをサポートしています。これは、Sheets APIが行ごとのタイムスタンプや変更カーソルを公開しないためです。 Workatoは増分同期ではなく、スケジュールされた実行ごとに選択したすべてのシートの全内容を再読み取りします。

実行ごとの完全な再読み取りにより、Google Forms送信やIMPORTRANGE() Formulaからの変更を含め、変更方法に関係なくデータの変更を正しく取得できます。

削除追跡 ​

オブジェクトをアップサートするか上書きするかは、オブジェクトを追加するときに主キーを設定するかどうかによって異なります。

• 主キーを設定済み: Workatoは主キーで照合して行をアップサートします。 シートから削除された行は送信先に残り、削除済みとしてマークされます。
• 主キーなし: Workatoは同期ごとに送信先テーブル全体を上書きします。 シートから削除された行も送信先から削除され、削除済み行の履歴はありません。

スキーマとデータ型の処理 ​

Google Sheetsからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

型推測 ​

すべての列をテキストとして同期するには、列型を推測をいいえ（デフォルト）に設定します。 代わりに各列の型をデータから推測するには、はいに設定します。型は狭いものから広いものへ、boolean、integer、long、double、decimal、textの順に推測されます。

Workatoは、初回同期時に列の型を一度だけ推測し、その後は自動的に拡張しません。 後続の同期で、数値として推測された列にテキストが含まれるなど、推測された型と一致しない値が検出されると、その行は同期に失敗します。 列の値の型を変更する必要がある場合は、オブジェクトのスキーマをリセットします。

列名 ​

Workatoは、スペースや特殊文字を含め、シートの列ヘッダーを入力されたとおりに正確に保持します。 Workatoは、SQLセーフな識別子を必要とする送信先に書き込む場合、列名を有効な識別子に自動的に変換します。

機密データの処理 ​

Google Sheetsの列スキーマは完全にお客様が定義するため、同期される任意のシートの任意の列に個人を特定できる情報（PII）やその他の機密データが含まれる可能性があります。 固定されたオブジェクトカタログを持つコネクターとは異なり、Workatoはどのフィールドが機密であるかを事前に予測できません。

機密データを含むスプレッドシートを同期する前に、その列を確認し、そのまま送信先に到達させるべきでない列をマスクするには、フィールドレベルのデータ保護でハッシュオプションを使用します。 詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Google Sheetsをデータパイプラインソースとして使用する場合、次の制限事項が適用されます。

1,000万セルの制限 ​

Google Sheetsでは、タブごとではなくすべてのタブを合わせて、スプレッドシートあたり1,000万セルという厳格なプラットフォーム制限が適用されます。 たとえば、5つのタブを持つスプレッドシートは、1つの1,000万セルのプールを共有します。 デフォルトの列数26では、シートは約385,000行で上限に達します。最大列数18,278では、約547行で上限に達します。 この制限はWorkatoではなく、Googleによって適用されます。

Shared Driveのスプレッドシートはサポートされていません ​

このコネクターは現在、Shared Drive（Team Drive）に保存されているスプレッドシートをサポートしていません。 個人のGoogle Drive（My Drive）に保存されているスプレッドシートを使用してください。

Domain-Wide Delegationはサポートされていません ​

サービスアカウントは、明示的に共有されているスプレッドシートにのみアクセスできます。 サービスアカウントが所有していないシートへのアクセス権を継承できるDomain-Wide Delegationはサポートされていません。

APIキー認証はサポートされていません ​

Googleの公開APIキーでは非公開スプレッドシートへのアクセス権が付与されないため、WorkatoはこのコネクターでAPIキー認証をサポートしていません。 代わりにOAuth 2.0またはサービスアカウントを使用してください。