CouchDB-ドキュメントの作成

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

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
}

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

$ 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を示します。ドキュメントを改訂(更新または変更)するたびに_rev値はCouchDBによって生成されます。ドキュメントを更新または削除する場合、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"
}

布団を使ったドキュメントの作成

ドキュメントを作成するには、 http://127.0.0.1:5984/_utils/ 以下に示すように、CouchDBの概要/インデックスページを取得するためのURL。

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

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

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

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

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

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

ドキュメントを保存

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