メインコンテンツへスキップ

​
認証

Connect AI API へのすべてのリクエストは、OAuth または基本認証を使用して適切に認証される必要があります。詳細については、認証 を参照してください。

​
ワークスペース

ワークスペースをクエリするには、REST API URL に「workspace」という名前の URL パラメータを追加します。クエリするワークスペースの名前をこれに設定します。これはメタデータエンドポイントの GET 操作と、クエリおよびバッチエンドポイントの POST 操作の両方で機能します。なお、/exec エンドポイントはワークスペースをサポートしていません。

​
レスポンス形式

Connect AI API の操作は、操作によって以下を含む可能性がある共通のレスポンス形式を共有しています。
  • 1つ以上の結果セット（以下を含む）：
    • 結果カラムのメタデータ
    • 行の値（存在する場合）
    • 影響を受けた行数
  • 出力パラメータと戻りパラメータ（該当するストアドプロシージャ実行時）
  • リクエスト処理の前、実行中、または実行後に発生したエラー
API が返すレスポンスオブジェクトには、以下に示す 1つ以上のトップレベルプロパティが含まれます。 
{
  "results": [
    {
      "schema": [
        {
          "ordinal": <int>,
          "catalogName": "<string>",
          "schemaName": "<string>",
          "tableName": "<string>",
          "columnName": "<string>",
          "columnLabel": "<string>",
          "dataType": <int>,
          "dataTypeName": "<string>",
          "length": <int>,
          "precision": <int>,
          "scale": <int>,
          "nullable": <bool>
        },
        ...
      ],
      "rows": [
        [<any>, <any>, ...],
        ...
      ],
      "affectedRows": <int>,
    },
    ...
  ],
  "parameters": {
    "@p1": { "dataType": <int>, "direction": <int>, "value": <any> }
    ...
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

​
プロパティ

プロパティ説明
resultsクエリの結果セットの配列。結果セットごとに 1つのオブジェクト。
schema結果セットのカラムスキーマの配列。
ordinal結果セット内のカラムの位置。0 から始まります。
catalogNameカラムのカタログ名。
schemaNameカラムのスキーマ名。
tableNameカラムのテーブル名。
columnNameカラムの名前。
columnLabelカラムのラベル。
dataTypeカラムの データ型。
dataTypeNameカラムのデータ型名。データソース固有の場合があります。
lengthバイナリ/文字列カラムの場合は最大文字数。その他のデータ型の場合は表示長。
precisionカラムの精度。該当しない場合は省略。
scaleカラムのスケール。該当しない場合は省略。
nullableカラムが null 許容かどうか。
rows行の値配列の配列。各ネストされた配列は結果セット内の 1行を表し、各カラムの行の値が含まれます。
affectedRows影響を受けた行数。該当しない/利用できない場合は -1。
parametersストアドプロシージャによって生成された出力、入出力、または戻りパラメータ。結果にそのようなパラメータがない場合は省略。
dataTypeパラメータの データ型。
directionパラメータの方向：入出力は 2、出力は 4、戻り値は 5。
valueパラメータの値。
error発生したエラーに関する情報。エラーが発生しなかった場合は省略。
codeエラーコード。
messageエラーメッセージ。

​
エラー

Connect AI が API リクエストを受信すると、検証し、実行し、結果が届き次第シリアライズしてストリーミングで返します。実行前または実行中にエラーが発生した場合、レスポンスオブジェクトにはエラー情報のみが含まれます。ただし、クエリの結果の返却が開始された 後 にエラーが発生することもあります。その場合、レスポンスオブジェクトには部分的な結果とともに、結果が不完全であることを示すエラー情報が含まれることがあります。 HTTP ステータスコードはボディの前に返されるため、不完全なレスポンスの HTTP ステータスは 200 OK になります。そのため、HTTP ステータスコードのみに頼らず、レスポンスにエラー情報が含まれているかどうかを常に確認することが重要です。

​
データ型

次の表は、結果セットのシリアライズにおける dataType プロパティの有効な値を示しています。
値意味表現
1BINARYJSON String; Base64-encoded
2VARBINARYJSON String; Base64-encoded
3LONGVARBINARYJSON String; Base64-encoded
4BLOBJSON String; Base64-encoded
5VARCHARJSON String
6TINYINTJSON Number
7SMALLINTJSON Number
8INTEGERJSON Number
9BIGINTJSON Number
10FLOATJSON Number
11DOUBLEJSON Number
12DECIMALJSON String; format: valid JSON number
13NUMERICJSON String; format: valid JSON number
14BOOLEANJSON Boolean (true/false)
15DATEJSON String; format: yyyy-MM-dd
16TIMEJSON String; format: HH:mm:ss.fffffff
17TIMESTAMPJSON String; ISO8601 format: yyyy-MM-ddTHH:mm:ss.fffffffZ
18UUIDJSON String; format: {01234567-890a-bcde-f012-34567890abcd}