Couchdb-creating-a-document
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の新しいドキュメントを作成しています。
このページでは、ドキュメントの保存、フィールドの追加、添付ファイルのアップロードの3つのオプションを確認できます。
ドキュメントにフィールドを追加
ドキュメントにフィールドを追加するには、 Add Field オプションをクリックします。 データベースを作成したら、このオプションを使用してデータベースにフィールドを追加できます。 それをクリックすると、一対のテキストボックス、つまり*フィールド、値*が表示されます。これらの値をクリックして編集できます。 これらの値を編集して、目的のフィールドと値のペアを入力します。 緑色のボタンをクリックして、これらの値を保存します。
次の図では、従業員の名前、年齢、および指定の3つのフィールドを作成しました。
文書を保存
このオプションをクリックすると、ドキュメントに加えられた変更を保存できます。 保存後、以下に示すように新しいID _rev が生成されます。