保つ エアテーブル DuckDBファイルに合わせて、 スケジュール通りに
SQL文を一度書くだけで、Query Streamsが5分ごとから週ごとまで、指定したスケジュールで実行し、Airtableテーブルにデータを書き込みます。キーで行を照合すれば、編集内容がそのまま反映され、クエリから外れた行は削除されます。もちろん、単純に行を追加することも可能です。Zapierもスクリプトもエクスポートも不要です。初回は約15分で完了し、無料プランで利用できます。
最終的に手に入るもの
DuckDBクエリが返す行を格納するAirtableテーブル。5分ごとから週ごとまでのスケジュールに従って更新され、実行ごとに変更内容のレシートが送信されます。例:
DuckDBはデータをファイルに保存します。チームはAirtableで作業します。通常、この連携にはZapierやMakeのシナリオ、または誰かがアップロードしたCSVファイルが静かに壊れて一度に1行ずつコピーされるという方法が使われます。Query Streams Automationはこれとは異なります。DuckDBファイルを既に読み込んでいるエージェントが、保存済みのSQLをスケジュールに基づいて実行し、結果全体を一度にAirtableに書き込みます。キーに基づいて行を照合することで、テーブルが肥大化するのではなく、常に正しい状態を維持します。
必要なもの
DuckDBはエージェント経由で接続しました
DuckDB ファイルが保存されているコンピューター、またはネットワーク共有からファイルを読み取るコンピューターにエージェントをインストールし、データ エージェントに接続を追加します。まだ完了していませんか? まずDuckDBに接続してください。所要時間は約10分です。
Airtableのログイン情報
Airtableでは、クエリ ストリームがレコードの読み書き、およびテーブル構造の読み書きを、ユーザーが選択したデータベースで行うことを承認するよう求められます。ワークスペースの設定によっては、パーソナル アクセス トークンを使用することもできます。
作業はどこで行われますか? エージェントを実行しているコンピューター上で、スケジュールに従ってクエリを実行し、結果をAirtableに書き込むため、そのコンピューターは起動したままにしておく必要があります。ブラウザは閉じても構いません。Query Streams自体は、結果を保存しません。
別のコンピューターにファイルがありますか? エージェントは、DuckDBファイルが保存されているコンピュータ上で実行する必要はありません。ネットワーク共有からファイルを読み込むことができます。 ネットワーク共有上のファイルにアクセスする以下に、それに必要なことを示します。
6つのステップで設定できます
-
同期を維持したいクエリを保存します
開く クエリビルダーDuckDB の接続を選択してください (まだ接続していませんか? ここから始めましょう)、Airtable で必要な行と列を正確に返す SELECT 文を記述します。これは、いくつかの列を抽出します。 オーダー テーブル:
例:SQLSELECT order_id, customer_name, order_total FROM main.orders ORDER BY order_total DESC LIMIT 100;
実行してから セーブ 分かりやすい名前(例:「Airtable の注文」)を付けてください。SELECT では、行ごとに一意の列を保持してください。 注文IDこれが、Full Syncが該当行をその場で更新するために使用する鍵です。後でクエリを編集して再保存すると、自動化処理は次回の実行時に変更を反映します。
-
Automationを開いてAirtableを選択します。
ポータルで、 オートメーション (トップメニュー) ストリーム → スケジュール済み → 自動化)そしてクリック 新しい自動化魔法使いには5つの短いステップがあります。 ステップ1 クリック エアテーブル カード。
代わりに「始める前に」というメッセージが表示される? ウィザードは、エージェントがオンライン接続を確立し、かつ少なくとも1つの保存済みクエリが存在する場合にのみ開きます。ページには、3つの条件のうちどれが不足しているかが表示され、該当箇所へのリンクが表示されます。
-
Airtableを接続する
の上 ステップ2 クリック Airtableに接続するAirtableが開き、クエリ ストリームが使用できるベースを尋ね、返されます。Airtableは、選択したベースでクエリ ストリームがレコードの読み書き、およびテーブル構造の読み書きを許可するかどうかを尋ねます。ワークスペースが推奨する場合は、パーソナル アクセス トークンも使用できます。一度接続済みですか?ページには、 この接続を使用する その代わり。
-
行が着地する場所を選択してください
の上 ステップ3 選ぶ ベースすると、 テーブル 行はどこに配置されるべきか。最初からやり直すのが一番簡単です。 新しいテーブルを作成する名前を入力してクリック 作成するクエリ ストリームは、クエリの列からフィールドを作成します。テーブルに既に行が存在する場合は、プレビューが表示され、各同期モードがそれらの行に対してどのような処理を行うかが説明されます。テーブルごとに 1 つの自動化が可能です。
-
クエリを選択し、行がどのように配置されるかを決定します。
の上 ステップ4 開く 保存されたクエリー ステップ1で作成したクエリを一覧表示して選択します。クエリストリームは、そのクエリを一度実行して列を読み込み、返される行数を表示し、2つの選択肢を表示します。
追加・高速追加
クエリを実行するたびに、クエリの行がテーブルの末尾に追加されます。更新も削除もされないため、ログ、イベント、履歴などを蓄積するのに最適な方法です。キー列は不要です。変更のない行は再度追加されず、値が変更された行は新しい行として下に追加され、古い行はそのまま残ります。
フル同期・ミラーフルシンク
行は、 鍵 注文IDなどの列。新しい行が追加され、変更された行はそのまま更新され、クエリから返されなくなった行は削除されます。これには、手動でテーブルに入力された行も含まれるため、手動で入力された行は別のテーブルに保持してください。これは、在庫、パイプライン、マスターデータ、ダッシュボードに適しています。
フル同期は列ごとに設定されるため、共有テーブルで特に役立ちます。
- 鍵
- 行を識別する列、例えば 注文IDクエリ結果内で一意である必要があります。クエリ ストリームはそれを自動的にチェックし、重複を拒否します。
- 同期
- 実行ごとにDuckDBから上書きされます。Airtableで同期列を編集した場合、次の実行時に元の値が復元されます。
- 保存する
- 行が最初に到着したときに書き込まれ、その後は比較されないため、DuckDB で変更されても更新はトリガーされません。チームが手動で入力するメモ、担当者、フォローアップ日については、クエリにまったく含まれていない列を使用してください。Airtable にのみ存在する列は、同期によって変更されることはありません。
どちらが速いですか? 追加モードでは、テーブルを読み込むことなく書き込みが行われます。完全同期モードでは、テーブルを読み込み、すべての行を比較し、差分のみを書き込むため、処理時間は長くなりますが、テーブルは常にクエリと一致します。これらのモードは、自動化設定の編集パネルから後から切り替えることができます。
信頼できるテーブルについては、こちらをクリックしてください。 すべての列を同期として作成する次に、鍵のアイコンをクリックします。 注文ID それを実現するために 鍵クエリ ストリームは結果全体をスキャンしてキーが一意であることを確認し、一意でない場合は警告します。クエリの一部ではない列にチーム独自のメモを残してください。それらの列は決して変更されません。常に増加するログについては、ここをクリックしてください。 すべての列を保持するように作成します 代わりに、キーをスキップします。クリックします。 続く.
-
スケジュールを設定し、名前を付け、作成します
の上 ステップ5 選ぶ スケジュール通りに実行する そして選ぶ 頻度:
頻度 走る 5分ごとに 5分ごとに、最速で許可されている 15分ごとに 15分ごと 30分ごと 30分ごと 毎時間 毎時ちょうどに 毎日午前9時 毎日午前9時、デフォルト 毎日午前6時 毎日午前6時 平日午前9時 月曜日から金曜日の午前9時 毎週(月曜日午前9時) 毎週月曜日午前9時 カスタムスケジュール あなた自身の分、時間、曜日、または日付 時代は続く タイムゾーン 選択すると、ブラウザの起動時に表示されます。 マニュアルのみ そして押す 走る いつでも好きな時に実行できます。スケジュールは後から自動化の編集パネルから追加できます。スケジュールされた実行はエージェント上で実行されるため、ブラウザを閉じても実行は継続されます。実行予定時刻にエージェントを実行しているコンピュータの電源がオフになっている場合、実行されなかった分はエージェントが再起動した直後に一度だけ実行されます。
与えて 統合名「Airtableへの注文、毎日」など、 創作の準備はできましたか? 概要とクリック 自動化を作成するオートメーションページに戻り、 走る スケジュールを待たずに、今すぐ最初の同期を実行してください。Airtableを開くと、列ヘッダーの下に行が表示されます。
それでおしまい。 今後は、テーブルが自動的に最新の状態に保たれます。クエリが返した行以外はネットワークから何も送信されず、誰も何かを実行することを覚えておく必要もありません。
その後に目にするもの
の 自動化ページ すべての自動化をステータス、ソース、ターゲット、キー、スケジュール、最終同期、行数とともに一覧表示します。 処刑 タブ:トリガー(手動またはスケジュール)、実行時間、作成、更新、削除、変更された行を含むすべての実行。 パフォーマンス このタブには、7日から90日間に処理されたデータ量と成功率が表示されます。
停止した時に通知されます
すべての組織には 同期の問題 初日から適用されるアラートルール:同期が失敗した場合、アプリ内通知とメールが送信され、復旧した場合にも再度通知が送信されます。1件のインシデントにつき1つのメッセージが送信され、再試行のたびにメッセージが送信されることはありません。この機能をオフにするか、ストリーム → アラートとレポートでチャンネルを変更してください。
一時停止すべき時に一時停止する
Airtableが接続を受け付けなくなった場合、またはデータコネクタが削除された場合、自動化処理は一時停止し、その理由が表示されます。再接続するか、新しいソースを選択して「再開」を押してください。その他のエラーが発生した場合は、スケジュールは継続され、該当する行に表示されます。
キー列がありません
Airtableでキー列の名前を変更したり削除したりすると、Full Syncは何も書き込む前に停止し、 修正オプション列を元の名前に戻して、再度実行してください。他の列は同期によって削除されることはありません。
計画で許可されている内容
自動化機能は無料プランを含むすべてのプランで利用可能で、作成できる自動化の数に制限はありません。ただし、各プランで制限されるのは、1回の実行で1つのクエリが返すことができる行数です。
| プラン | 1回の実行あたりの行数 |
|---|---|
| 無料 | 125 |
| 個人的な核心 | 500 |
| パーソナルプラス | 1,000 |
| ビジネスコア | 2,500 |
| ビジネスプラス | 5,000 |
| ビジネスマックス | 10,000 |
| エンタープライズコア | 25,000 |
| エンタープライズプラス | 100,000 |
| エンタープライズマックス | 250,000 |
クエリがより多くのデータを返す場合、実行は途中で中断されるのではなく保留され、自動化システムはどのプランが適切か、または日付範囲などのフィルターを追加することを提案します。正常に実行された各実行は、Excel および Sheets クエリで使用されるのと同じデータ レルムの割り当て量にカウントされます。 価格ページをご覧ください 手当のために。
良い次の動き
- フィルターを追加する クエリに対して、例えば過去90日間などを指定することで、テーブルのサイズを小さく保ち、処理速度を向上させ、プランの行制限に適合させます。
- 手書きのメモは専用の列に記入してください。クエリの外側にあるため、すべての同期で存続します。
- 自動化をグループ化する いくつか設定したら、編集パネルから「自動化」ページをグループごとにフィルタリングします。
ネットワーク共有上のファイルにアクセスする
エージェントは、ユーザーとしてではなく、バックグラウンドサービスとしてファイルを開くため、別のコンピューター上のファイルを開くには追加の手順が必要です。どの手順が必要かは、エージェントが実行されているコンピューターによって異なります。
テストで共有フォルダにアクセスできない場合は、結果の中に以下の単語を探してください。 到達不能 エージェントのコンピュータがサーバーから応答を受け取らなかったことを意味します。Linux または Mac では、 取り付けられていません これは、共有フォルダがまだマウントされていないことを意味し、そのメッセージにはサーバー用の正確なマウントコマンドが含まれています。
共有フォルダにDuckDBファイルがありますか? DuckDB は一度に 1 つの書き込みしか許可しないため、エージェントは他のプログラムが書き込み用に開いているファイルを開くことができません。 \\server\share テストによると、パスは 別のプログラムによる書き込みを受け付けていますそこで閉じるか、誰も書き込みを行っていないファイルにコネクタを指定してください。すべてのクエリはネットワーク経由でファイルを読み込むため、大きなファイルはローカルディスクから読み込む場合よりも応答が遅くなります。
共有フォルダでのテストが失敗しましたか?
すべての実行は、接続テストと同じ方法でファイルにアクセスします。ファイルサーバーで何かが変更された後(たとえば、新しいパスワードに変更した後)に実行が失敗し始めた場合は、コネクタを開いてください。 データエージェント そしてクリック 接続テストテスト結果とファイルパスの下の行に、問題点が示されます。
| メッセージ | 原因 | 修理 |
|---|---|---|
| DuckDBデータベースファイルが見つかりません: 続いて \\server\share 正しいと分かっている道 | ログイン情報が保存されていないため、エージェントは自身のアカウントとして共有を試みました。しかし、ファイルを見ることができませんでした。共有側がそのアカウントを拒否したか、サーバーが応答しなかったかのどちらかです。最初のケースでは、パスの下の行に次のように表示されます。 エージェントのサービスアカウントへのアクセスが拒否されました. | クリック サービスID パスの下に、共有フォルダを読み取ることができるログイン情報を保存してください。パスの下の行に「アクセス拒否」と表示されていない場合は、エージェントのコンピュータがそもそも共有フォルダを開くことができるかどうかを確認してください。 |
| 共有サーバー: アクセスが拒否されました — このサーバーの認証情報を追加してください | ログイン情報は保存されていますが、そのアカウントには共有フォルダへのアクセス権がないか、同じサーバーへの別のサインインが妨げとなっています。どちらの原因かは、この行の前のメッセージに示されています。 | サーバー管理者に、そのアカウントに読み取りアクセス権限を付与するよう依頼するか、読み取りアクセス権限を持つアカウントを保存してください。サインインが妨げられている場合は、以下の「サーバーごとに1つのログイン」に関する2行を参照してください。 |
| 共有サーバー: 認証情報が拒否されました。ユーザー名とパスワードを確認してください。 | サーバーが保存されたログインを拒否しました。入力ミス、ドメインの間違い、または保存後にパスワードが変更された可能性があります。これにより、以前は正常に動作していた実行も停止します。 | パスの下にあるチップをクリックして、もう一度パスワードを入力してください。サーバー自体で作成したアカウントの場合は、そのままにしておいてください。 ドメイン 空白。ログインが拒否された場合、エージェントは同じログインを再度試行する前に1分間待機するため、アカウントはロックアウトされません。修正したパスワードを保存すると、すぐに試行されます。 |
| 共有サーバー: エージェントマシンからサーバーに到達できません | エージェントのコンピューターはサーバーから応答を得られませんでした。サーバー名が間違っているか、サーバーがオフになっているか、ファイアウォールがファイル共有をブロックしている可能性があります。 | エージェントのコンピューターで、同じものを開きます。 \\server\share ファイルエクスプローラーでパスを確認してください。それでも解決しない場合は、ネットワークを管理している担当者のネットワークの問題です。 |
| このエージェント上の別のコネクタは既に \\server にサインインしています… | Windowsでは、1台のコンピューターが一度に1つのアカウントでサーバーにサインインできますが、このエージェント上の別のコネクタは、そのサーバーに対して別のログイン情報を使用します。 | 他のコネクタが使用するログイン情報を保存するか、そのサーバーを読み取るすべてのコネクタでログイン情報を変更してください。 |
| Windows には既に \\server へのサインイン機能があります… | エージェントのコンピューター上で、エージェント以外の何かが既に別のアカウントでそのサーバーにサインインしており、エージェントは自分が行っていないサインインを閉じない。 | メッセージの残りの部分に従ってください。このコネクタで同じアカウントを使用するか、エージェントのコンピューターで他のサインインを閉じます。共有が既にそのサインインで読み取り可能であると表示される場合は、 サービスIDを使用する 代わりにログインボックスに入力してください。 |
| このエージェントビルドでは、保存されている認証情報を使用して \\server にサインインできません。 | このエージェントは旧バージョンであり、保存されたログイン情報を使用できません。 | エージェントを更新してから、再度テストしてください。 |
| \\server\share はこの Linux エージェントにマウントされていません (または macOSエージェント) | エージェントはLinuxまたはMac上で動作し、共有フォルダはまだそのコンピュータにマウントされていません。そのため、ポータルに保存されているログイン情報はエージェントでは使用されません。 | メッセージに表示されているコマンドでマウントし、再度テストしてください。手順は以下のとおりです。 Linux上で - Macで. |
| …は別のプログラムによる書き込みを受け付けています。 | DuckDBでは一度に1つの書き込みしかできず、別のプログラムが書き込みのためにファイルを開いておく必要があります。 | そのプログラムでファイルを閉じるか、誰も書き込みを行っていないファイルにコネクタを指定してください。 |
人々が尋ねる質問
同期によって、私のチームがAirtableに追加したメモは上書きされますか?
メモが独自の列にある場合はそうではありません。Airtable にのみ存在し、クエリには存在しない列は変更されないため、同期された列の横にメモまたは所有者列を追加してそこに入力します。 同期 実行ごとにDuckDBの値に戻されます。 保存する 行が最初に到着したときに列にデータが入力され、その後は比較されません。
私のDuckDBデータはクエリストリームに保存されますか?
いいえ。エージェントはお客様側でクエリを実行し、暗号化されたリンクを介して行をAirtableに直接送信します。クエリストリームは、構成、スケジュール、および実行ごとの行数を保持しますが、行自体は保持しません。
コンピューターは電源を入れたままにしておく必要がありますか?
エージェントを実行しているコンピューターが処理を実行します。なぜなら、クエリを実行してAirtableに書き込むのはエージェントだからです。ご自身のノートパソコンとブラウザは閉じていても構いません。実行予定時刻にコンピューターの電源が切れていた場合、実行が中断されたとしても、エージェントが再起動した直後に一度だけ実行されます。
後でクエリを変更できますか?
はい。クエリビルダーで編集して保存すると、次回の実行時に自動的に新しいバージョンが使用されます。列を追加または削除した場合は、オートメーションの編集パネルを開いてマッピングしてください。
2つの自動化プロセスが同じテーブルに書き込むことはできますか?
いいえ、テーブルごとに自動化は1つだけです。2つ目の自動化を別のテーブルに向けるか、最初の自動化の背後にあるクエリを拡張してください。
無料プランで本当にこれがカバーされるのですか?
はい。無料プランは、期限切れのトライアルではなく、継続して利用できるプランです。自動化はすべてのプランに含まれています。プランによって異なるのは、1回の実行で1つのクエリが返すことができる行数です。無料プランに含まれる内容については、 価格ページ.
関連ガイド
すべてのガイド DuckDB
あなたの設定とは少し違いますか?
- DuckDBデータベースファイルではなく、Parquetファイルのフォルダをお持ちですか?Parquet Folderはそれらをすべて1つのテーブルとして読み取ります→ Parquet Folder
設定に問題がありますか?
- エージェントがファイルまたはフォルダが存在しない、またはアクセスが拒否されたと報告しますか?マップされたドライブ、ネットワーク共有、OneDrive、Linuxホームフォルダそれぞれに修正が必要です → エージェントがファイルを読み取ることができる場所
- エージェントがオフラインと表示される、または接続テストと参照がグレー表示されている場合?エージェントがオンラインであることを確認してください → エージェントはオンラインですか?

