概要
このページでは、API 接続を最初から最後まで設定するために必要な手順の例を示します。この例では、車両のメンテナンススケジュールを含むAPI を使用します。API 接続の作成
最初に、新しいAPI 接続を作成します。1
Connect AI ナビゲーションメニューのSources ページを開きます。
2
右上隅の + Add Connection をクリックします。
3
開いたAdd Connection ダイアログでAPI と入力し、API コネクタタイルを表示してからそのタイルをクリックします。
4
Global Settings Tab で接続に名前を付けます。この例では「TestAPI」を使用します。
5
認証方法を選択します。このAPI では認証が不要なため、
No Auth を選択します。6
この接続にはヘッダーが不要なため、このセクションは空白のままにします。
7
ページネーションを設定します。このAPI は次のページのURL を使用し、レスポンスの一部として次のページのURL を提供します。以下の例は、Vehicles エンドポイントからのレスポンスの関連部分を示しています:
8
Pagination のType を
URL に設定します。9
URL Path を
/nextLink に設定します。10
ページ上部のCreate ボタンをクリックしてAPI 接続を保存します。
テーブルの作成
カタログに対応する接続を追加したので、API の各エンドポイントに対してテーブルを作成できます。1
API 接続でTables をクリックしてTables タブを開きます。
2
Add をクリックして新しいテーブルを追加します。
3
テーブルのName を指定します。これは、クライアントからアクセスする際にテーブルが表示される名前です。例:
Vehicles。4
Response Type を
JSON のままにし、Request 呼び出しを GET にします。5
Request URL をAPI エンドポイントのURL に設定します。この例では
https://my_vehicles/api を使用します。6
このAPI にはパラメータがないため、Parameters セクションを空白のままにします。
7
同様に、Headers も空白のままにします。
8
Table Data セクションでConfigure をクリックしてTable Data 情報を自動入力します。これによりPreview Request が開き、以下のAPI レスポンスが表示されます。
9
Next をクリックしてAdd Columns メニューにアクセスします。ここで、ルートパスと公開するカラムを選択する必要があります。
Root Path は、繰り返しサブ要素を含むJSON 要素であり、テーブルの行を決定します。この場合、このドキュメント内に複数の要素が繰り返し出現するため、複数のルートパスを選択する必要があります。ルート要素がネストされているため、この例に示すように、一部のデータは各行で繰り返されます。レスポンスの以下のスニペットに示すように、これら 2 つの繰り返しセクションのデータも必要なため、
people 要素はユーザーごとに繰り返されるため、まずこの要素を選択します:vehicles と maintenance の要素も選択します。
注: JSON 配列は角括弧 [] を使用してJSON オブジェクトの配列を格納し、各オブジェクトは中括弧 {} で囲まれています。10
この例では、people 配列から
first、last、vehicles 配列から type、model、maintenance 配列から date、description を公開するカラムとして選択します。11
Next をクリックしてTable Preview にアクセスします。現在の設定でテーブルの最初の 10 行がレンダリングされます。正しく設定されている場合は、選択した各カラムのデータが表示されます。
12
Confirm をクリックしてTable Data 設定を自動的に追加します。選択したデータはTable Data セクションのRoot Path およびColumns フィールドに反映されます。
13
Save をクリックしてこのテーブルを保存します。
クエリのテスト
接続とテーブルを設定した後、Data Explorer でクエリを実行してテストできます。1
Connect AI でData Explorer に移動します。
2
Connections リストで、先ほど作成した
TestAPI 接続を選択します。これにより、この例で作成した Vehicles テーブルを含む、その接続のすべてのテーブルが展開されます。3
このテーブルの横の省略記号をクリックしてquery を選択します。これにより、すべての車両を取得するSQL クエリが自動的に生成されます:
SELECT * FROM [TestAPI].[REST].[Vehicles]このSQL クエリを必要に応じて変更できます。例えば、特定のモデルの車両のみを選択するWHERE句を追加できます。SELECT * FROM [TestAPI].[REST].[Vehicles] WHERE model='Honda Civic'
4
Execute をクリックしてこのクエリを実行します。すべてが正しく設定されている場合、結果がすぐに表示されます。
TestAPI に設定する必要がある場合があります。
このソースをAI でご利用ください。 クイックスタートの手順に従い、Claude、ChatGPT、Copilot、またはその他のAI クライアントをMCP 経由でこのソースに接続してください。アプリケーションのモデルリクエストを、ガバナンスされた単一のエンドポイント経由でルーティングするには、LLM Gateway を参照してください。Connect AI を初めてご利用になる場合は、Connect AI の無料アカウントを作成し、わずか数分で最初のコネクション設定を完了できます。