行の作成

# 行の作成

### 単一行の作成

{{%badge%}}**newRow()**{{%/badge%}}メソッドを使用して、指定されたインスタンスの{{%link href="/ja/cloud-scale/help/data-store/introduction"%}}Data Store{{%/link%}}テーブルに新しい行を作成できます。カラム名と対応する行の値をキーと値のペアとして指定することで、テーブル内の行の値を設定する必要があります。

以下のコード構文で使用される{{%badge%}}&lt;ROW_INSTANCE&gt;{{%/badge%}}は、{{%link href="/ja/sdk/flutter/v2/cloud-scale/data-store/create-row-instance"%}}行インスタンスページ{{%/link%}}で定義されたインスタンスです。

{{%code class="language-bash line-numbers"%}}Future<(APIResponse, ZCatalystRow)> &lt;ROW_INSTANCE&gt;.create(){{%/code%}}

{{%note%}}{{%bold%}}注意:{{%/bold%}} {{%badge%}}{{%bold%}}is_unique{{%/bold%}}{{%/badge%}}または{{%badge%}}{{%bold%}}is_mandatory{{%/bold%}}{{%/badge%}}プロパティが有効な状態でカラムが作成された場合、値がそれぞれ一意であること、または必須で渡されることを確認する必要があります。また、カラムに渡すデータがカラムに設定されたデータ型であることも確認する必要があります。{{%/note%}}

行インスタンスの作成を含むサンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}var row = ZCatalystApp.getInstance()
      .getDataStoreInstance()
      .getTableInstance(identifier: 'Products')
      .newRow(); //テーブルの行インスタンスを定義し、行のキーと値のデータを渡す
  row.setColumnValue('product_name', 'power_bank');
  row.setColumnValue('product_price', 2000);
  row.setColumnValue('product_quantity', 2);

try {
   var (response, row) = await row.create();
   print('New row created successfully : ${row.id}');
} on ZCatalystException catch (ex) {
  print('Failed to create the row: $exception');
}{{%/code%}}

<br>

### 複数行の作成

Catalyst Flutter SDKでは、指定されたインスタンスのテーブルに複数の行を一度に作成できます。テーブルに挿入する必要がある行を含むリストを渡すことで実行されます。以下のコード構文に示すように、リストは{{%badge%}}**createRows()**{{%/badge%}}メソッドの引数として渡されます。

以下のコードで使用される{{%badge%}}&lt;TABLE_INSTANCE&gt;{{%/badge%}}は、{{%link href="/ja/sdk/flutter/v2/cloud-scale/data-store/create-table-instance"%}}テーブルインスタンスページ{{%/link%}}で定義されたインスタンスです。

{{%code class="language-bash line-numbers"%}}Future<(APIResponse, List&lt;ZCatalystRow&gt;)> &lt;TABLE_INSTANCE&gt;.createRows(List&lt;ZCatalystRow&gt; rows){{%/code%}}

**パラメータ**:

* {{%badge%}}**rows**{{%/badge%}}: 作成する行の配列

行インスタンスの作成を含むサンプルコードスニペットを以下に示します：

{{%code class="language-bash line-numbers"%}}List&lt;ZCatalystRow&gt; newRows = []; //配列を作成する
//作成する行の行インスタンスを定義する
  ZCatalystRow row1 = 
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row1.setColumnValue('product_name', 'a');
  row1.setColumnValue('product_price', 25);
  row1.setColumnValue('product_quantity', 50);

ZCatalystRow row2 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row2.setColumnValue('product_name', 'b');
  row2.setColumnValue('product_price', 30);
  row2.setColumnValue('product_quantity', 40);

ZCatalystRow row3 =
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row3.setColumnValue('product_name', 'c');
  row3.setColumnValue('product_price', 25);
  row3.setColumnValue('product_quantity', 70);
//配列に行インスタンスを追加する
  newRows.add(row1);
  newRows.add(row2);
  newRows.add(row3);
try{
  var (response, rows) = await dataStore.getTableInstance(identifier: 'Products').createRows(rows: newRows);
  for (var row in rows) {
            print(row.id); //行の正常な作成時に実行するアクション
  }
} on ZCatalystException catch (ex) {
  print('The IDs of the rows that were successfully created are listed below:')
}{{%/code%}}

単一行の作成

newRow()メソッドを使用して、指定されたインスタンスのData Storeテーブルに新しい行を作成できます。カラム名と対応する行の値をキーと値のペアとして指定することで、テーブル内の行の値を設定する必要があります。

以下のコード構文で使用される<ROW_INSTANCE>は、行インスタンスページで定義されたインスタンスです。

copy

         Future<(APIResponse, ZCatalystRow)> <ROW_INSTANCE>.create()

注意: is_uniqueまたはis_mandatoryプロパティが有効な状態でカラムが作成された場合、値がそれぞれ一意であること、または必須で渡されることを確認する必要があります。また、カラムに渡すデータがカラムに設定されたデータ型であることも確認する必要があります。

行インスタンスの作成を含むサンプルコードスニペットを以下に示します：

copy

var row = ZCatalystApp.getInstance()
      .getDataStoreInstance()
      .getTableInstance(identifier: 'Products')
      .newRow(); //テーブルの行インスタンスを定義し、行のキーと値のデータを渡す
  row.setColumnValue('product_name', 'power_bank');
  row.setColumnValue('product_price', 2000);
  row.setColumnValue('product_quantity', 2);
try {
var (response, row) = await row.create();
print(‘New row created successfully : ${row.id}’);
} on ZCatalystException catch (ex) {
print(‘Failed to create the row: $exception’);
}

複数行の作成

Catalyst Flutter SDKでは、指定されたインスタンスのテーブルに複数の行を一度に作成できます。テーブルに挿入する必要がある行を含むリストを渡すことで実行されます。以下のコード構文に示すように、リストはcreateRows()メソッドの引数として渡されます。

以下のコードで使用される<TABLE_INSTANCE>は、テーブルインスタンスページで定義されたインスタンスです。

copy

         Future<(APIResponse, List<ZCatalystRow>)> <TABLE_INSTANCE>.createRows(List<ZCatalystRow> rows)

パラメータ:

rows: 作成する行の配列

行インスタンスの作成を含むサンプルコードスニペットを以下に示します：

copy

List<ZCatalystRow> newRows = []; //配列を作成する
//作成する行の行インスタンスを定義する
  ZCatalystRow row1 = 
      dataStore.getTableInstance(identifier: 'Products').newRow();
  row1.setColumnValue('product_name', 'a');
  row1.setColumnValue('product_price', 25);
  row1.setColumnValue('product_quantity', 50);
ZCatalystRow row2 =
dataStore.getTableInstance(identifier: ‘Products’).newRow();
row2.setColumnValue(‘product_name’, ‘b’);
row2.setColumnValue(‘product_price’, 30);
row2.setColumnValue(‘product_quantity’, 40);
ZCatalystRow row3 =
dataStore.getTableInstance(identifier: ‘Products’).newRow();
row3.setColumnValue(‘product_name’, ‘c’);
row3.setColumnValue(‘product_price’, 25);
row3.setColumnValue(‘product_quantity’, 70);
//配列に行インスタンスを追加する
newRows.add(row1);
newRows.add(row2);
newRows.add(row3);
try{
var (response, rows) = await dataStore.getTableInstance(identifier: ‘Products’).createRows(rows: newRows);
for (var row in rows) {
print(row.id); //行の正常な作成時に実行するアクション
}
} on ZCatalystException catch (ex) {
print(‘The IDs of the rows that were successfully created are listed below:’)
}

最終更新日 2026-03-30 13:40:30 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Data Store Records Insert Row - API