CouchDB-ドキュメントの作成

ドキュメントはCouchDBの中心的なデータ構造です。データベースの内容は、テーブルではなくドキュメントの形式で保存されます。これらのドキュメントは、CouchDBとFutonが提供するcURLユーティリティを使用して作成できます。この章では、データベースにドキュメントを作成する方法について説明します。

CouchDBの各ドキュメントには一意のIDがあります。文字列の形式である必要がある独自のIDを選択できます。通常、UUID（Universally Unique IDentifier）が使用されます。これは、重複を作成する可能性が最も少ない乱数です。これらは衝突を避けるために好まれます。

cURLユーティリティを使用してドキュメントを作成する

cURLユーティリティを介してPUTメソッドを使用してHTTP要求をサーバーに送信することにより、CouchDBでドキュメントを作成できます。ドキュメントを作成する構文は次のとおりです。

$ curl -X PUT http://127.0.0.1:5984/database name/"id" -d ' { document} '

*-X* を使用すると、HTTPサーバーと通信しながら、使用しているHTTPのカスタムリクエストメソッドを指定できます。 この場合、PUTメソッドを使用しています。 PUTメソッドを使用する場合、urlのコンテンツは、HTTPリクエストを使用して作成するオブジェクト名を指定します。 ここでは、次を送信する必要があります-

ドキュメントを作成しているデータベース名の名前。
ドキュメントID。 ドキュメントのデータ。 -d *オプションは、HTTP要求を介してデータ/ドキュメントを送信するために使用されます。文書を書いている間、下に示すように花括弧内にコロンで区切られたフィールドと値のペアを入力してください-

{
   Name : Raju
   age : 23
   Designation : Designer
}

例

*my_database* という名前のデータベースにID *001* のドキュメントを作成する場合、上記の構文を使用して、次のように作成できます。

$ curl -X PUT http://127.0.0.1:5984/my_database/"001" -d
'{ " Name " : " Raju " , " age " :" 23 " , " Designation " : " Designer " }'

{"ok":true,"id":"001","rev":"1-1c2fae390fa5475d9b809301bbf3f25e"}

この要求に対するCouchDBの応答には3つのフィールドが含まれています-

*「OK」、*操作が成功したことを示します。
* "id"、*文書のidを保存し、
* "rev"、これはリビジョンIDを示します。ドキュメントを修正（更新または変更）するたびに、CouchDBによって *_rev 値が生成されます。ドキュメントを更新または削除する場合、CouchDBは、変更するリビジョンの _rev フィールドを含めることを想定しています。 CouchDBが変更を受け入れると、新しいリビジョン番号が生成されます。このメカニズムにより、同時実行制御が保証されます。

検証

作成されたドキュメントを表示する場合は、次のようにドキュメントを使用して取得できます。

$ curl -X GET http://127.0.0.1:5984/my_database/001
{
   "_id": "001",
   "_rev": "1-3fcc78daac7a90803f0a5e383f4f1e1e",
   "Name": "Raju",
   "age": 23,
   "Designation": "Designer"
}

Futonを使用してドキュメントを作成する

ドキュメントを作成するには、 http：//127.0.0.1：5984/_utils/ URLを開き、以下に示すようにCouchDBのOverview/indexページを取得します。

ドキュメントの作成

ドキュメントを作成するデータベースを選択します。データベースの概要ページを開き、以下に示すように*新しいドキュメント*オプションを選択します。

新しいドキュメント

[新しいドキュメント]オプションを選択すると、CouchDBは新しいデータベースドキュメントを作成し、新しいIDを割り当てます。 idの値を編集し、文字列の形式で独自の値を割り当てることができます。次の図では、ID 001の新しいドキュメントを作成しています。

新しいドキュメントID

このページでは、ドキュメントの保存、フィールドの追加、添付ファイルのアップロードの3つのオプションを確認できます。

ドキュメントにフィールドを追加

ドキュメントにフィールドを追加するには、 Add Field オプションをクリックします。データベースを作成したら、このオプションを使用してデータベースにフィールドを追加できます。それをクリックすると、一対のテキストボックス、つまり*フィールド、値*が表示されます。これらの値をクリックして編集できます。これらの値を編集して、目的のフィールドと値のペアを入力します。緑色のボタンをクリックして、これらの値を保存します。

次の図では、従業員の名前、年齢、および指定の3つのフィールドを作成しました。

フィールドの作成

文書を保存

このオプションをクリックすると、ドキュメントに加えられた変更を保存できます。保存後、以下に示すように新しいID _rev が生成されます。

ドキュメントの保存

Couchdb-creating-a-document

CouchDB-ドキュメントの作成

cURLユーティリティを使用してドキュメントを作成する

例

検証

Futonを使用してドキュメントを作成する

ドキュメントにフィールドを追加

文書を保存

目次