--- title: "はじめに" url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/ description: "Catalyst NoSQLは、非リレーショナル・非SQLのデータストレージ手段を提供するフルマネージドで強力なデータベースです。NoSQLテーブルでのデータの作成、管理、クエリを簡単に行い、Java、Node.js、PythonでCRUD操作を実行できます。" last_updated: 2026-02-23T12:39:41Z service: Cloud Scale type: general --- # NoSQLでのデータ操作 NoSQLのデータ単位は*アイテム*と呼ばれ、各データアイテムはリレーショナルデータベースのレコードや行に相当します（この[用語](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#basic-components)で説明しています）。Catalystでは、[Java](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/get-table-metadata/)、[Node.js](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/get-component-instance/)、[Python](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/get-component-instance/)のサーバーサイドSDKおよびAPIを使用して、NoSQLテーブルでCRUD操作を実行できます。 > **注意:** CatalystコンソールからもCRUD操作を実行して、NoSQLでのデータ操作をテストできます。ただし、コンソールからはテーブルに1つのアイテムのみ追加できます。 Catalystは、次のセクションで説明するCatalystカスタムJSON形式でデータを追加する機能を備えた、キーバリューペアベースのドキュメント型データストレージをサポートしています。 > **注意:** テスト用として、Catalystコンソールからのみ国際標準構文に従った通常のJSON形式でデータを追加できます。ただし、SDKおよびAPIで作業する場合は、カスタムJSON形式でのみデータを追加できます。 Catalystでは、JSONデータで複数のデータ型を使用でき、NoSQL属性をそれらで設定できます。テーブルにデータを追加または更新する際に、属性に適切なデータ型を宣言できます。 ### サポートされるデータ型 Catalyst NoSQLの[属性](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#basic-components)でサポートされるデータ型を以下に示します。
データ型 表記 説明
String `S` 文字のシーケンスを格納
Number `N` 数値を格納
Binary `B` バイトのシーケンスを表すバイナリ数値を格納
Boolean `BOOL` `true`または`false`のブール値を格納
Set of String `SS` 1つ以上の一意の文字列を格納するセット
Set of Numbers `SN` 数値のコレクションを格納するセット
Set of Binary `SB` バイナリ数値のコレクションをバイトセットとして格納するセット
List `L` 同じデータ型の順序付き要素を格納
Map `M` キーバリューペア要素の順序なしコレクションを格納
Null `NULL` `NULL`という値のみを格納
NoSQLでデータを追加する際のこれらのデータ型の表記と使用方法については、[CatalystカスタムJSON形式セクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format)を参照してください。 > **注意:** * コンソールからNoSQLのテーブルまたはインデックスを設定する場合、Catalystではテーブルの[プライマリキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)に**String**または**Number**の2つのデータ型のうちの1つのみを選択できます。これにはパーティションキー、ソートキー、追加ソートキーが含まれます。 * NoSQLテーブルにデータを追加または更新する際は、宣言したデータ型に一致する適切な値を属性に常に追加するようにしてください。データ型と値の不一致はエラーをスローします。 ### CatalystカスタムJSON形式 CatalystカスタムJSONは、CatalystがNoSQLで処理できるJSONデータの形式です。構文は標準JSON形式に似ていますが、各属性に設定された[データ型](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types)の指定が追加されています。 CatalystカスタムJSON形式を理解するために、サンプルテーブルを見てみましょう。 #### サンプルテーブルの表現 **テーブル名**- Employees ```json { "item": { "EmpID": { "N": "10999" }, "FirstName":{ "S": "Paul" }, "LastName":{ "S": "Smith" }, "YearOfJoining":{ "N": 2011 }, "PriorExperience":{ "BOOL": false }, "Location": { "M": { "Country": { "S": "USA" }, "City": { "S": "New York" } } } }, "item": { "EmpID": { "N": "10113" }, "FirstName":{ "S": "Lana" }, "LastName":{ "S": "Belle" }, "YearOfJoining":{ "N": 2019 }, "PriorExperience":{ "BOOL": true }, "Department": { "S": "IT" } }, "item": { "EmpID": { "N": "29123" }, "FirstName":{ "S": "Kevin" }, "LastName":{ "S": "Wilson" }, "YearOfJoining":{ "N": 2023 }, "Clubs":{ "L": [ { "S": "Innovate" }, { "S": "Swimmers of NPY" }, { "S": "Technova" } ] } } } ``` *Employees*テーブルには、`Location`属性の下にネストされたJSONプロパティと、配列値を持つ属性`Clubs`が含まれています。このテーブルでは、各属性は設定されたデータ型で表記されています。例えば、`EmpID`と`YearOfJoining`には`N`（Number）、`FirstName`と`LastName`には`S`が使用されています。ブール属性`PriorExperience`は`BOOL`として表記されています。 使用可能なすべてのデータ型とその表記については、[サポートされるデータ型セクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types)を参照してください。 #### 重要な注意事項: * テーブルのプライマリキー（パーティションキーとソートキー）は、テーブルにデータを追加または更新するためのアイテムを構築する際にルートに存在する必要があります。ここに示されている形式は表現のみです。このJSON形式で各サーバーサイドSDKのデータを構築するフォーマットは異なります。 * テスト用として、CatalystコンソールからNoSQLテーブルのデータを標準JSON形式またはCatalystカスタムJSON形式のいずれかで追加または更新できます。 * [Java](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/get-table-metadata/)、[Node.js](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/get-component-instance/)、[Python](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/get-component-instance/)のサーバー固有のSDK、またはAPIを通じてNoSQLテーブルにデータを追加または更新する場合は、CatalystカスタムJSON形式でのみ行えます。SDKヘルプリソースには、そのプログラミング環境でのデータアイテムの構築と挿入のフォーマットと例が含まれています。 * コンソールからデータを追加または更新する際に標準JSON形式を使用する場合、テーブルまたはインデックスの作成時にプライマリキー属性に関連付けられたデータ型が自動的に処理されます。その他のすべての属性については、提供された値に基づいてCatalystがデータ型を自動的に認識します。