---
title: "NoSQL アイテムの構築"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/construct-item/
description: "Catalyst NoSQLは、非リレーショナルでNoSQLのデータストレージを提供する、完全マネージドで強力なデータベースです。このページでは、さまざまなデータ型のNoSQLアイテムを構築するメソッドについて説明します。"
last_updated: 2026-03-30T08:10:30Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /ja/cloud-scale/help/nosql/introduction
  - name: "Basic Components"
    url: /ja/cloud-scale/help/nosql/components/#basic-components
  - name: "Supported Data Types in NoSQL"
    url: /ja/cloud-scale/help/nosql/working-with-data/introduction/
---

# NoSQLアイテムの構築

[Catalyst NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)のアイテムは、単一のデータポイント（レコードのようなもの）のデータを保持する属性のコレクションを表します。プロジェクト内の既存のNoSQLテーブルに、[カスタムJSON形式](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format)でアイテムを挿入または更新できます。ただし、Catalystでアイテムを挿入または更新する前に、アイテムを構築する必要があります。

以下のセクションで説明するように、Catalystがサポートするさまざまなデータ型の属性を含むNoSQLアイテムを構築できます。Catalystは、String、Number、Set of Strings、Set of Numbers、List、Mapなど、いくつかのデータ型をサポートしています。[サポートされているデータ型](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types)の完全なリストを参照してください。

テーブルに設定したパーティションキー属性の値は、すべてのデータアイテムで必ず提供する必要があります。テーブルキー、TTL属性、その他の詳細については、[テーブルキーのヘルプセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)を参照してください。

### 新しいNoSQLアイテムの作成

以下に示すように、`zcatalyst-sdk-node`パッケージの一部である`no-sql`ライブラリをrequireした後、`NoSQLItem()`メソッドを使用して新しいNoSQLアイテムを作成できます。

```javascript
const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql');
const item = new NoSQLItem() // 新しいNoSQLアイテムを作成
```

### 文字列のNoSQLアイテムの構築

以下の例では、文字列値とネストされたJSON属性`color`をMapとして含むアイテムを構築します。

```javascript
const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql');
const item = new NoSQLItem() // 新しいNoSQLアイテムを作成
// 文字列値を追加する
.addString('fruit', 'mango')
// マップを追加する
.addMap('properties', {
color: 'yellow'
});
```

### NoSQLバイトの構築

バイトのシーケンスを表すために使用されるバッファオブジェクトを作成し、*Binary*データ型の値を格納するNoSQLバイトを作成できます。以下に示すように、生のバイナリデータバッファを表す`ArrayBuffers`オブジェクトを使用するか、ASCII形式でバイナリデータを表すBase64文字列から、2つの方法でバイトを作成できます。

```javascript
const { NoSQLByte } = require('zcatalyst-sdk-node/lib/no-sql');
// NoSQL Byteを作成する
const buff = Buffer.from('Hello world !!!'); // バッファオブジェクトを作成
const byte = new NoSQLByte(buff); // ArrayBuffersオブジェクトを使用してNoSQLバイトを作成
const byteA = new NoSQLByte(buff.toString('base64')); // Base64文字列からNoSQLバイトを作成
```

### NoSQLバイトセットの構築

Catalystでは、バイトのシーケンスを表すために使用されるバッファオブジェクトを作成し、*Set of Binary*データ型のバイナリ値のコレクションを格納するNoSQLバイトセットを作成できます。生のバイナリデータバッファを表す`ArrayBuffers`オブジェクトを使用するか、ASCII形式でバイナリデータを表すBase64文字列からバイトセットを作成できます。

また、構築済みのバイトをバイト配列として渡すことで、バイトセットを作成することもできます。

```javascript
const { NoSQLByte, NoSQLByteSet } = require('zcatalyst-sdk-node/lib/no-sql');
// NoSQL Byte Setを作成する
const buff = Buffer.from('Hello world !!!'); // バッファオブジェクトを作成
const byte = new NoSQLByte(buff); // ArrayBuffersオブジェクトを使用してNoSQLバイトを作成
const byteA = new NoSQLByte(buff.toString('base64')); // Base64文字列からNoSQLバイトを作成
const byteSet = new NoSQLByteSet([byte, byteA]); // NoSQLバイト配列からNoSQLバイトセットを作成
const byteSetA = new NoSQLByteSet([buff.toString('base64')]); // NoSQL Byteを作成する set from a Base64 string array
const byteSetB = new NoSQLByteSet([buff]); // NoSQL Byteを作成する set using the ArrayBuffers object
```

### NoSQL文字列セットの構築

以下に示すように、文字列配列から*Set of String*データ型のNoSQL文字列セットを作成できます。

```javascript
const { NoSQLStringSet } = require('zcatalyst-sdk-node/lib/no-sql');
// NoSQL string setを作成する
const stringSet = new NoSQLStringSet(['hello', 'world']); // NoSQL string setを作成する from a string array
```

### NoSQL数値セットの構築

以下に示すように、数値またはBigInt値の配列から*Set of Numbers*データ型のNoSQL数値セットを作成できます。

```javascript
const { NoSQLNumberSet } = require('zcatalyst-sdk-node/lib/no-sql');
// NoSQL number setを作成する
const numberSet = new NoSQLNumberSet([123, 1234n]); // 数値またはBigInt値の配列からNoSQL数値セットを作成
```

### NoSQLアイテムの操作

Catalystでは、NoSQLアイテムに対して、プレーンJavaScriptオブジェクトからNoSQLアイテムを作成する、またはその逆の操作などの操作を実行できます。アイテムのデータを標準JSON形式で含むプレーンJavaScriptオブジェクトを構築して、NoSQLアイテムを作成できます。以下のサンプルコードに示すように、`NoSQLItem.from()`を使用してJSオブジェクトからNoSQLアイテムを構築できます。

また、コードに示すように、`itemFromObj.to()`を使用してNoSQLアイテムをプレーンJavaScriptオブジェクトに戻すこともできます。

```javascript
const { NoSQLItem } = require('zcatalyst-sdk-node/lib/no-sql');
// オブジェクトを定義する
const obj = {
fruit: 'apple', // パーティションキー
properties: {
color: 'red'
}
};
const itemFromObj = NoSQLItem.from(obj); // プレーンJSオブジェクトからNoSQLアイテムを構築
const plainJsObject = itemFromObj.to(); // アイテムをプレーンJSオブジェクトに変換
```