TiDBAdvent Calendar 2024

TiDB CloudのZapier連携を試す

Posted at 2024-12-07

はじめに

TiDB Cloudには3rd Partyツールとの連携機能があり、現時点で下記5つのサービスとの連携が可能です。

この中でメトリクスを連携するDataDogやNewRelicはよく使われますが、Zapier連携は使ったことがなかったので何ができるのか調べて使ってみました。

Zapierは様々なツールを連携して一連の自動化ワークフローを作成できるツールです。イベントソースとなるサービスからイベントを受け取り、他のサービスに連携させることで様々な組み合わせを実現できます。

TiDBからのイベント発火（トリガー）と、TiDBへのイベントに応じた実行（アクション）が定義されていて、詳細は下記のドキュメントから確認できます。

アクションの対象はTiDB Cloud Serverlessに限定されているようです

本記事では、たまに聞かれる「TiDB Cloudで誰かがクラスタを作成したら通知してほしい」という機能を実現してみます。TiDB Cloudのトリガーとしてクラスタの作成があるので、クラスタ作成されたらメールが飛ぶようにしてみます。

Zapier連携時に利用するため、APIキーを作成しておきます。Organization Settings>API Keysで、キーを作成し、表示されたPUBLIC KEYとPRIVATE KEYをメモしておきます。

Project Settings から Zapier連携を選択するだけです。Zapierの画面に遷移するので、アカウントの作成もしくはログインを行います。

Zapier側でZap(ワークフロー）の設定画面になるので設定をしていきます。図のようなZapを作成します。

次のConfigure画面では、トリガーの対象となるTiDB Cloudのプロジェクトを選択します。

Testで、実際にこの設定でクラスタが取得できるか確認することができます。

アクションは任意ですが、ここではEmailを使ってみました。アクションを追加する際に、Emailで検索するとEmail by Zaiperが選択できると思います。

Setupでは、Actionとして Send Outbound Email を選択します。

Configureでは、メールの宛先とメール本文を設定します。メール本文では、/を入力することでイベントの内容を埋め込むことができます。ここでは、クラスタ名、組織id、リージョンを埋め込みました。

ここまでできたら、Publishボタンを押してこのZapを有効化します。

このZapをためしてみます。指定したプロジェクトでServerlessクラスタを新規で立ち上げて、しばらくするとメールが届きます。メール本文にはクラスタ名が記載されていて正しく動作することがわかります。

今回はメールでしたが、SlackやSMSにも連携することができるので、会社で利用する際などに使えるかもしれません。（クラスタの削除のトリガーとかもほしい気がしますが）

他にもデータベースが作成されたときや、データベースに行が挿入されたとき、といったトリガが設定可能です。データベースからイベントを発生させる連携は珍しいので、ぜひ色々ためしてみてください！