Airtableをデータパイプラインのソースとして構成する ​

Airtableをデータパイプラインのソースとして設定し、Airtableのベースとテーブルからレコードを抽出して宛先に同期します。

このガイドでは、機能と前提条件の確認、データパイプラインのソースとしてのAirtableへの接続、パイプラインの構成、サポート対象のオブジェクト、同期モード、スキーマの処理、制限事項について説明します。

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

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

• クラウド接続: https://api.airtable.comを介してHTTPSでAirtableに接続します。オンプレミスエージェントは不要です。
• 動的なオブジェクト検出: Workatoは選択したAirtableのベース内にあるすべてのテーブルを自動的に検出し、各テーブルを同期可能なオブジェクトとして公開します。詳細については、サポートされているオブジェクトを参照してください。
• 完全同期と増分同期: Workatoはすべてのテーブルで完全同期をサポートします。有効なLast Modified Timeフィールドがあるテーブルでは、増分同期もサポートされます。詳細については、同期モードを参照してください。
• 削除の追跡: 連続する完全スナップショットを比較し、完全同期するテーブルの削除を検出します。詳細については、削除追跡を参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護：データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
• 構成可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。サポートされる最小間隔は15分です。

前提条件 ​

Airtableをデータパイプラインのソースとして接続するには、以下が必要です。

• 同期する予定のベースとテーブルへのアクセス権を持つAirtableアカウント。アクセスできるベース、テーブル、フィールドはAirtableアカウントと認可スコープによって異なるため、同期する予定のベースがトークンまたはOAuthによる許可のアクセス対象に含まれている必要があります。
• 選択した認証方法の認証情報:
  • 個人アクセストークン: 少なくともdata.records:readとschema.bases:readのスコープが設定された個人アクセストークン。 AirtableドキュメントのCreating personal access tokensを参照してください。
  • OAuth 2.0: AirtableのOAuthフローを通じてWorkatoを認可する権限を持つAirtableアカウント。

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

Airtableのデータパイプラインは、次の認証方法をサポートします。

• 個人アクセストークン: Airtableアカウントで生成した個人アクセストークンを使用して接続します。必要なスコープについては、前提条件を参照してください。
• OAuth 2.0: Airtableにサインインし、Airtableの認可フローを通じてアクセスを許可して接続します。

Airtableは2024年1月末に従来のAPIキー認証を廃止しました。データパイプラインはAPIキー認証をサポートしません。

Airtableへの接続 ​

Airtableコネクターは、次の認証タイプをサポートしています:

• Personal access token
• OAuth 2.0

Personal access token ​

Personal access token認証を使用して、Airtableアカウントから生成されたトークンでAirtableに接続します。

Personal access tokenの作成 ​

AirtableドキュメントのCreating personal access tokensを参照してください。

Personal access tokenを使用したAirtableへの接続 ​

WorkatoでAirtableへのPersonal access tokenコネクションをセットアップするには、次の手順を実行します:

OAuth 2.0 ​

OAuth 2.0を使用してAirtableに接続するには、Airtableの認可フローでサインインし、アクセスを許可します。

最小スコープとデフォルトスコープ ​

スコープdata.records:readおよびschema.bases:readは常にリクエストされます。追加のスコープが選択されていない場合、コネクションのデフォルトはdata.records:read、schema.bases:read、data.records:write、およびschema.bases:writeです。

選択する追加スコープがAirtableプランでサポートされていることを確認してください。サポートされていないスコープを選択すると、コネクションエラーが発生する場合があります。たとえば、スコープView metadata about workspaces, bases, and views including collaboratorsはworkspacesAndBases:readに対応しており、BusinessプランおよびEnterprise Scaleプランでのみ利用できます。

Airtable OAuth scopes and associated plansの詳細については、Airtableドキュメントを参照してください。

OAuth 2.0を使用したAirtableへの接続 ​

WorkatoでAirtableへのOAuth 2.0コネクションをセットアップするには、次の手順を実行します:

パイプラインの設定 ​

Airtableをデータパイプラインのソースとして構成するには、次の手順を実行します。

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

0 8 * * *

サポートされるオブジェクト ​

Airtableのベースとテーブルはすべてお客様が定義するため、Airtableのデータパイプラインは固定されたオブジェクトカタログから同期するわけではありません。 Workatoは選択したベース内のすべてのテーブルを検出し、各テーブルを個別の同期可能なオブジェクトとして公開します。ベース名が利用可能な場合、オブジェクト選択画面には<Base name> / <Table name>というラベルで表示されます。ベースIDのみを指定して検出範囲を限定した場合は、代わりに<Base ID> / <Table name>と表示されることがあります。

Workatoはテーブルとフィールドを検出するために、Airtableのベーススキーマにもクエリを実行します。ベーススキーマは同期可能なオブジェクトとして公開されません。

同期モード ​

Airtableのデータパイプラインは完全同期と増分同期をサポートします。すべてのテーブルで完全同期がサポートされます。編集可能なフィールドの変更を追跡するよう構成された有効なLast Modified Timeフィールドを持つテーブルでは、増分同期もサポートされます。利用可能なモードはテーブルのスキーマによって異なります。有効なカーソルフィールドがないテーブルでは、完全同期のみが可能です。

フル同期 ​

Workatoは、有効なLast Modified Timeフィールドを持つテーブルを含め、すべてのテーブルで完全同期をサポートします。完全同期ではテーブル内のすべてのレコードを抽出し、宛先のレコードセットを置き換えます。

増分同期 ​

Workatoは、有効なLast Modified Timeフィールドを持つすべてのテーブルに増分同期を適用します。各増分同期では、前回の同期成功以降に変更されたレコードのみを取得します。同期の境界付近で変更されたレコードを見逃さないよう、1時間のローリングオーバーラップ期間を使用します。

Airtableには削除を増分的に検出する方法がないため、増分同期するテーブルでは削除の追跡がサポートされません。詳細については、削除追跡を参照してください。

削除追跡 ​

完全同期するテーブルでは削除の追跡がサポートされます。パイプラインは各完全同期の結果を前回の実行結果と比較し、Airtableに存在しなくなったレコードに宛先の_workato_is_deleted列で印を付けます。

増分実行では前回の実行以降に変更されたレコードのみを読み取り、削除を検出できないため、増分同期するテーブルでは削除の追跡がサポートされません。 Airtableは削除されたレコードを示すAPIシグナルを提供しません。

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

コネクターは、データを宛先に複製する際、特定のAirtableフィールドタイプに対して固有の処理を適用します。

フィールド名の変更 ​

Workatoは、Airtable内部のフィールドIDではなく、Airtableでの現在の表示名で各フィールドを識別します。 Workatoは、次回テーブルのスキーマを検出した際、名前が変更されたフィールドを既存の宛先列のラベル変更としてではなく、別のフィールドとして扱います。

ネストされたフィールド値と添付ファイルのフィールド値 ​

添付ファイル、コラボレーター、リンクされたレコード、ルックアップ、ロールアップフィールドなどのAirtableフィールドタイプは、ネストされた値またはリスト形式の値を返します。 Workatoは、これらの値を個別の列にフラット化するのではなく、JSON文字列として複製します。添付ファイルフィールドでは、添付ファイルのURLを含むファイルのメタデータのみが複製されます。 Workatoは添付ファイルをダウンロードしません。詳細については、添付ファイルのデータはダウンロードされないを参照してください。

データ型マッピング ​

Airtableのフィールドタイプは、次の宛先の型にマッピングされます。

Airtableが新たに導入するフィールドタイプを含め、Workatoが明示的にマッピングしていないAirtableのフィールドタイプは、メタデータの生成が失敗しないよう文字列として複製されます。

合成列 ​

Workatoは、すべてのAirtableレコードオブジェクトに次の合成列を追加します。

すべてのレコードオブジェクトには、Airtable固有のidフィールドとcreatedTimeフィールドも含まれ、それぞれ主キーと作成日時として使用されます。

機密データの処理 ​

Airtableのテーブルはすべてお客様が定義するため、Workatoはベース内のどのフィールドに個人を特定できる情報（PII）やその他の機密データが含まれているかを予測できません。テーブルをパイプラインに追加する前に、テーブルのスキーマを確認してください。

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

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

添付ファイルのデータはダウンロードされない ​

Workatoは添付ファイルのURLを含むメタデータを複製しますが、実際のファイルはダウンロードしません。 Airtableの添付ファイルURLは数時間以内に期限切れになることがあるため、同期したURLを後でファイルの取得に使用できるとは限りません。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。これより高い頻度で同期をトリガーすることはできません。

Airtable APIのレート制限 ​

AirtableはAPIリクエストを、ベースごとに毎秒5件、個人アクセストークンまたはOAuthトークンごとに毎秒50件に制限します。 Airtableから429 Too Many Requestsが返された場合、コネクターは30秒待ってから再試行します。そのため、同時実行数の多いパイプラインは完了までに時間がかかることがあります。