Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Data Store

Catalyst Data Storeは、アプリケーションの永続データをテーブル形式で保存するクラウドベースのリレーショナルデータベース管理システムです。

Data Store APIを使用すると、プロジェクトのData Store内のテーブルにレコードを挿入・管理したり、テーブルやカラムの詳細を取得したり、一括読み取りや一括書き込みのアクションを実行したりできます。ただし、テーブルとそのスキーマの作成はCatalystコンソールからのみ行えます。

テーブルへの新しい行の挿入

説明

このAPIを使用すると、テーブルの一意のIDまたは名前を指定して、Data Store内のテーブルにデータの新しい行(レコード)を挿入できます。

以下に説明するように、リクエスト内のJSON配列でレコードのカラム名とその対応する値を渡す必要があります。

注意:

  • テーブルとそのカラムは事前に作成されている必要があります。コンソールからテーブルを作成し、そのためのカラムを作成できます。

  • 開発環境では、各プロジェクトのテーブルごとに最大5,000件のレコードを挿入できます。開発環境では、各プロジェクト全体で最大25,000件のレコードを作成できます。本番環境ではレコード作成の上限はありません。

リクエスト詳細

リクエストURL

POST

{api-domain}/baas/v1/project/{project_id}/table/{tableIdentifier}/row

copy

api-domain
URL
Catalyst APIにアクセスするためのDC固有のドメイン

project_id
Numerical
プロジェクトの一意のID

tableIdentifier
Numerical
テーブルの一意のIDまたはテーブル名

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

任意のヘッダー

CATALYST-ORG: {org_id}

Environment: Development

スコープ

ZohoCatalyst.tables.rows.CREATE

注意: この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、Catalyst API前提条件セクションを参照してください。

リクエストJSON配列

以下のようなJSON配列でカラム名とその対応する値を送信する必要があります:

copy
{
    "column1_name": "column1_value",
    "column2_name": "column2_value",
    "column3_name": "column3_value",
    .
    .
}

ここでcolumn_nameはテーブル内の一意のカラム名、column_valueはレコード内のその対応する値です。


注意: レコードに挿入するカラム名と値のペアを少なくとも1つ送信する必要があります。

レスポンス詳細

レスポンスには、ROWIDやCREATEDTIMEなどの作成された行のメタデータと、挿入されたカラムのキー名と値が含まれます。

リクエスト例
copy

curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/table/EmpDetails/row
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type:application/json”
-d ‘[ { “Department_ID”:“IT678”, “Department_Name”:“Marketing”, “Employee_Name”:“Robert Page” } ]’

レスポンス例
copy
{
"status": "success",
"data": [
    {
        "CREATORID": "12096000000003003",
        "MODIFIEDTIME": "2023-06-05 11:35:14:332",
        "Department_ID": null,
        "Employee_Name": "Robert Page",
        "Department_Name": "Marketing",
        "CREATEDTIME": "2023-06-05 11:35:14:332",
        "ROWID": 12096000000642928
    }
]

}