SQLコネクタ関数の書き方

SQLコネクタ関数の書き方

このガイドを使用して、TulipアプリをSQLデータベースに接続します。

ここでは、Tulipのコネクタ機能を使用してSQLデータベースに接続する方法の例を示します。

新しいSQLコネクタを追加するには

1- メニューバーのAppsにカーソルを合わせ、ドロップダウンからConnectorsを選択して、Connectorsページに移動します。

2- 画面右上の "Add Connector "をクリックし、コネクタに名前を付け、コネクタタイプとして "SQL "を選択します。

3- 新しいコネクタの環境タブで、"接続の詳細を追加 "を選択します。

4- データベースに接続するための適切な詳細を入力します：

• Running On（別の設定をしていない限り、"Cloud Connector Host"）。
• タイプ
• サーバ
• ポート
• SSL（はいまたはいいえ）
• データベース
• ユーザー名
• パスワード

5- テストボタンをクリックしてテストシグナルを実行します。成功したら、「保存」をクリックします。

6- コネクタホストがデータベースにアクセスできることを確認します（コネクタページのサーバの横に緑色の「オンライン」ラベルが表示されます）。

新しいコネクタのセットアップに成功したら、外部データベースからデータを送信または取得するコネクタ関数を作成できます。コネクタ関数は、ターゲット・データベースの関連言語で記述する必要があります。

新しいSQLコネクタ関数をセットアップするには

1- Functionsタブの "Add New Function "ボタンをクリックします。

2- 新しい関数に名前を付けます（これにより、Triggers で特定のコネクタ関数を選択できます）。

1. 関数の入出力を設定する

上の例では

入力

• 設定（テキスト）

出力

• サブコンフィグ_1
• サブコンフィグ_2
• サブコンフィグ_3

クエリ

`SELECT subconfig_1, subconfig_2, subconfig_3 FROM webinar database WHERE configuration = $configuration$ order by id desc limit 1````.

関数は複数の入力と出力を持つことができます。Tulipアプリからデータを送受信するには、少なくとも1つの入力または出力が必要です。

• Addをクリックして、新しい入力または出力を追加します。
• フィールドにわかりやすい名前をつける
• データ型を選択する（テキスト、ブール、整数など）
• Queryフィールドに有効なSQL文を追加します。入力変数名は$で囲むことに注意してください。例
  input$.
• 関数をテストする
• 関数に入力がある場合は、有効な値を入力します。
• 右上の "Test "をクリックします。
• テスト結果セクションでテスト結果やエラーメッセージを見る

1. 場合によっては、SQL テーブルから複数の行を返したいこともあるでしょう。これを行うには、"Return Multiple Rows" の横のチェックボックスをオンにします。この場合、オブジェクトの配列が返され、各オブジェクトには SQL テーブルの 1 行分の値が含まれます。

クエリ

SELECT name, num from numbers where num > $number$.

(上の例では、numberは入力です)

そして、入力を追加して "Test "をクリックすると、"Test Results "の下に期待した行がすべて返されるはずです。

これらは、トリガーエディターでオブジェクトの配列として変数に格納できます。

7- 完了したら、"Save "を押す。

:::(Warning) (注意) 関数を保存した後、入力と出力を変更することはできません。これは、コネクター関数を使用しているアプリの中断を防ぐためです。
:::

新しい入出力を追加する必要がある場合は、関数をコピーして、新しい関数で変更することができます。

一般的に使用される SQL 関数の記述方法の詳細については、"一般的な SQL コネクタ関数" を参照してください。

さらに読む

• アプリケーションでコネクタ関数の出力を使用する方法
• HTTP コネクタの概要

お探しのものは見つかりましたか？

community.tulip.coで質問を投稿したり、他の人が同じような質問に直面していないか確認することもできます！