行の作成

# 行の作成

### 単一行の作成

{{%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/android/v2/cloud-scale/data-store/create-row-instance"%}}行インスタンスページ{{%/link%}}で定義されているインスタンスです。

{{%code class="language-bash line-numbers"%}}&lt;ROW_INSTANCE&gt;.create(
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest&lt;ZCatalystResponse&lt;ArrayList&lt;ZCatalystRow&gt;&gt;&gt;?
{{%/code%}}

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

以下にサンプルコードスニペットを示します：

{{%code class="language-bash line-numbers"%}}val row = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").newRow() //これをあなたのテーブル名に置き換えてください
    row.setColumnValue("Department_Name", "Marketing") //これをあなたの列名に置き換えてください and its value
    row.setColumnValue("Employee_ID", "109223") //これをあなたの列名に置き換えてください and its value
	row.setColumnValue("Employee_Name", "Robert Smith") //これをあなたの列名に置き換えてください and its value
    row.create(
        {
            success ->
            println("New row created successfully $success")
        },
        {
            exception ->
            println("Failed to create a new row! $exception")
        }
    )
{{%/code%}}

### 複数行の作成

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

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

{{%code class="language-bash line-numbers"%}}&lt;TABLE_INSTANCE&gt;.createRows(
    rows: ArrayList&lt;ZCatalystRow&gt;,
    success: (List&lt;ZCatalystRow&gt;) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest&lt;ZCatalystResponse&lt;ArrayList&lt;ZCatalystRow&gt;&gt;&gt;?
{{%/code%}}

**パラメータ**:

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

以下にサンプルコードスニペットを示します：

{{%code class="language-bash line-numbers"%}}ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").createRows( //これをあなたのテーブル名に置き換えてください
	rowsList, //カラムの名前と値を設定してarrayListに追加する
        {
            rows -> println("The IDs of the rows that were successfully created are listed below:")
            for (row in rows){
                println("${row.id}")
            }
        },
        {
            exception -> println("Add Rows Failed! $exception")
        })
{{%/code%}}

単一行の作成

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

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

copy

         <ROW_INSTANCE>.create(
    success: (ZCatalystRow) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

    

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

以下にサンプルコードスニペットを示します：

copy

         val row = ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").newRow() //これをあなたのテーブル名に置き換えてください
    row.setColumnValue("Department_Name", "Marketing") //これをあなたの列名に置き換えてください and its value
    row.setColumnValue("Employee_ID", "109223") //これをあなたの列名に置き換えてください and its value
	row.setColumnValue("Employee_Name", "Robert Smith") //これをあなたの列名に置き換えてください and its value
    row.create(
        {
            success ->
            println("New row created successfully $success")
        },
        {
            exception ->
            println("Failed to create a new row! $exception")
        }
    )

    

複数行の作成

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

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

copy

         <TABLE_INSTANCE>.createRows(
    rows: ArrayList<ZCatalystRow>,
    success: (List<ZCatalystRow>) → Unit,
    failure: ((ZCatalystException) → Unit)?
): ZCatalystRequest<ZCatalystResponse<ArrayList<ZCatalystRow>>>?

    

パラメータ:

rows: 作成する行の配列

以下にサンプルコードスニペットを示します：

copy

         ZCatalystApp.getInstance().getDataStoreInstance().getTableInstance("EmployeeDetails").createRows( //これをあなたのテーブル名に置き換えてください
	rowsList, //カラムの名前と値を設定してarrayListに追加する
        {
            rows -> println("The IDs of the rows that were successfully created are listed below:")
            for (row in rows){
                println("${row.id}")
            }
        },
        {
            exception -> println("Add Rows Failed! $exception")
        })

    

最終更新日 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