CouchDB快速入門


Apache CouchDB資料庫,它類似於Redis,Cassandra和MongoDB,也是一個NoSQL資料庫。 CouchDB將資料儲存為非關係性的JSON文件。 這使得CouchDB的使用者可以以與現實世界相似的方式來儲存資料。

可以從命令列或一個叫作Futon的Web介面來管理CouchDB。 Futon可用於執行管理任務,如建立和操作CouchDB的資料庫,文件和使用者等。

本文章的目標

在閱讀學習本文完後,您將學會以下知識:

  • 將CouchDB安裝在執行Ubuntu 14.04上。
  • 將Futon安裝在同一台伺服器上
  • 使用安全通道從本地機器存取CouchDB
  • 向CouchDB新增管理員使用者
  • 如何使用Futon執行CouchDB的CRUD操作
  • 從命令列執行CouchDB的CRUD操作

先決條件

請準備/完成以下兩個先決條件:

  • Ubuntu 14.04系統
  • 擁有管理許可權的使用者身份登入到伺服器

注意:本教學假設使用的是非root使用者,並可以執行root使用者許可權。請注意,如果您使用非root使用者,首次使用sudo執行命令時,系統將要求您輸入root使用者的密碼。

步驟1 - 準備伺服器

在安裝CouchDB之前,需要確保已經設定好了伺服器。

開始更新系統:

$ sudo apt-get update

安裝允許管理源儲存庫的軟體:

$ sudo apt-get install software-properties-common -y

注意:-y標誌告訴apt-get命令對安裝過程中可能出現的所有提示以Yes響應。 如果您喜歡手動響應提示,可以刪除此標誌。

新增PPA,以從相應的儲存庫獲取最新的CouchDB版本:

$ sudo add-apt-repository ppa:couchdb/stable -y

警告:在您的伺服器上新增一個新的個人包存檔(PPA)時,應該非常小心。 因為任何人都可以建立PPA,所以不能保證它是可信賴的,或者它是安全的。 在這種情況下,上述PPA是由Apache CouchDB團隊維護的官方PPA。

經過上一步,已經新增了一個新的PPA,接下來需要更新系統,使其具有最新的包資訊:

$ sudo apt-get update

現在可以安裝CouchDB和Futon了。

步驟2 - 安裝CouchDB

如果之前有在此伺服器上安裝過CouchDB,請先刪除現有版本,使用以下命令:

$ sudo apt-get remove couchdb couchdb-bin couchdb-common -yf

現在安裝CouchDB:

$ sudo apt-get install couchdb -y

這將在您伺服器上安裝CouchDB和Futon。

預設情況下,CouchDB在localhost上並使用埠5984執行,可以通過從命令列執行curl來檢索此基本資訊:

$ curl localhost:5984

注意:如果沒有安裝curl程式工具,可以使用sudo apt-get install curl命令進行安裝。

執行上面命令請求,應該得到類似於以下內容:

{"couchdb":"Welcome","uuid":"b9dsf278cfdas743b5fdfsaafd399fas7582e","version":"1.6.1","vendor":{"name":"Ubuntu","version":"14.04"}}

現在可以使用curl -X PUT命令建立一個新的資料庫:

curl -X PUT localhost:5984/new_database

執行後返回的響應結果如下 -

{"ok":true}

步驟3 - CouchDB安全保護

預設情況下,安裝CouchDB時建立的某些檔案和目錄屬於root使用者和組。 這在開發過程中雖然不錯,但這可能是生產中的安全風險。

安裝CouchDB時,它將建立一個使用者和一個名為couchdb的組。 在本節中,我們將把CouchDB檔案的所有權和許可權更改為couchdb使用者和組。

更改所有權控制CouchDB進程可以存取內容,並更改可以存取CouchDB檔案和目錄的許可權控制。

更改所有權和許可權之前,先停止CouchDB:

$ sudo stop couchdb

更改/usr/lib/couchdb,/usr/share/couchdb和/etc/couchdb目錄, 以及/usr/bin/couchdb可執行檔案的所有權,使其所有者為couchdb使用者,並且屬於couchdb組。

sudo chown -R couchdb:couchdb /usr/lib/couchdb /usr/share/couchdb /etc/couchdb /usr/bin/couchdb

現在,更改了/usr/lib/couchdb,/usr/share/couchdb和/etc/couchdb目錄, 以及/usr/bin/couchdb可執行檔案的許可權,以便couchdb使用者和couchdb組可自由存取(到CouchDB安裝),而其他使用者不可以存取這些檔案和目錄。

sudo chmod -R 0770 /usr/lib/couchdb /usr/share/couchdb /etc/couchdb /usr/bin/couchdb

現在重新啟動CouchDB:

sudo start couchdb

CouchDB現在應該啟動並執行,而沒有任何屬於root使用者或root組的檔案或目錄。

步驟4 - 存取Futon

CouchDB提供了一個基於Web的方便控制面板,它叫作:Futon。從本地伺服器存取它,將流量通過SSH連線隧道傳輸到您的伺服器。只有SSH登入到您的伺服器的使用者才能存取Futon控制面板。

要安全地連線到CouchDB(不用公開),您可以建立從本地埠5984到遠端伺服器埠5984的SSH隧道。

可以使用以下命令在本地計算機執行,以設定隧道:

$ ssh -L5984:127.0.0.1:5984 yiibai_user@your_server_ip

注意:請記住用您的使用者名替換yiibai_user,將your_server_ip替換為伺服器的IP地址。

連線開啟時,使用埠5984從Web瀏覽器存取Futon。存取此URL以顯示Futon頁面:

http://localhost:5984/_utils

預設情況下,存取Futon的所有CouchDB使用者都具有管理許可權。如在右下角所示:

可以通過點選修復此(Fix this)連結並建立新管理員來更改此內容。

步驟5 - 新增管理員使用者

現在已經啟動執行CouchDB,可以開始使用它了。

在建立管理員使用者之前,所有使用者都可以以管理許可權存取CouchDB(儘管它們首先需要SSH存取伺服器)。

為CouchDB建立管理員帳戶是一個很好的做法,以防止意外或未經授權的資料丟失。

要執行此操作,請單擊顯示在「Futon」的右下角的「修復此(Fix this)」連結。 這將顯示一個允許您建立CouchDB管理員使用者的螢幕,如下所示:

輸入使用者名和密碼:

輸入新的CouchDB使用者名和密碼後,單擊建立(Create)按鈕然後就建立新的管理員使用者。 Futon右下角的訊息將通過顯示類似於以下內容的訊息來確認:

注意:建立管理使用者可防止未經授權的使用者刪除和修改資料庫,設計文件和CouchDB組態。 但是,它不會阻止其它建立或存取文件。

就這樣,有關CouchDB伺服器現已完全組態。要了解有關使用資料庫的更多資訊,請繼續閱讀。

下面是一條美麗的分割線…


上面是一條美麗的分割線…

從Futon執行CRUD操作

Futon有一個非常簡單但有用的使用者介面,用來執行基本的CRUD操作(建立,讀取,更新和刪除)。

在本節中,我們將建立一個名為todos的新資料庫,向其中新增一個新文件,然後檢索,更新和刪除此文件。

注意:如果您已建立管理員使用者,則必須以管理員身份登入才能建立新的資料庫。

建立資料庫和文件

要建立一個名為todos的新資料庫,請單擊螢幕的左上方的建立資料庫(Create Database)連結。 這將出現類似如下對話方塊:

輸入資料庫的名稱:todos,然後單擊建立按鈕。

這將建立一個名為todos的新資料庫,並轉到可以在新建立的資料庫中建立和修改文件的頁面。

建立文件

要建立新文件,請單擊頁面上的「新建文件(New Document)」連結。

這將開啟一個帶有新文件的螢幕。 這個文件預設只有_id欄位。 如果需要,您可以更改此欄位的值,也可以按原樣保留。

單擊新增欄位(Add Field)連結以向此文件新增新欄位。

如上所述,我們新增了兩個名為todo和done的欄位。 預設情況下,新欄位具有空(null)值。可通過雙擊該值以更改它。

在這個例子中,我們雙擊了todo和done的值欄位,並分別輸入了Task 1和false。

輸入值後,按ENTER鍵或點選欄位旁邊的小綠色複選標記來儲存內容(不這樣做會使該欄位的值為空)。這應該如下所示:

要儲存文件,請單擊「儲存文件(Save Document)」連結。 儲存文件後,您將看到已經新增了_rev欄位,如下所示:

讀取檔案

單擊todos連結(在「概覽(Overview)」連結旁邊的頂部欄中)檢視新建立的文件,現在它是todos資料庫中的唯一文件。

單擊表格中的文件(ID)的鍵(紅色部分),以存取文件詳細資訊頁面。

編輯文件

在此頁面上,可以編輯和更新文件欄位,如下:

要編輯欄位值,可雙擊對應欄位並開始編輯。

您可以刪除任何欄位(除了_id和_rev欄位外),新增新欄位,或更改現有欄位的值。 在這個例子中,已經將done欄位的值從false更改為true,如下所示:

刪除文件

要刪除文件,可以單擊刪除文件連結,該連結將提示您進行確認:

刪除(Delete)按鈕進行確認。

Futon將刪除文件並跳轉到todos資料庫頁面,該頁面中文件現在應為空,確認文件確實已被刪除。

從命令列執行CRUD操作

本節將說明如何使用curl從命令列在CouchDB資料庫上執行基本的CRUD(建立,讀取,更新和刪除)操作。

建立資料庫

如果您尚未建立資料庫new_database,請按照以下步驟現在來建立。 該命令應從安裝CouchDB資料庫的伺服器上執行:

curl -X PUT http://localhost:5984/new_database -u "admin:password"
{"ok":true}

由於之前我們向CouchDB新增了管理員使用者,因此現在必須在建立新的資料庫時傳送管理員使用者名和密碼。
結果應如下所示:

{"ok":true}

建立文件

我們先來建立一個新的文件,使用以下請求命令:

curl -X POST -d '{"todo":"task 1", "done":false}' http://localhost:5984/new_database -H "Content-Type:application/json"

此命令將在new_database資料庫中建立一個新文件。

-X標誌表示執行HTTP POST方法請求操作。 由於POST方法請求傳送一個JSON文件,所以後面的-H標誌將此請求的內容型別設定為application/json。 最後,包含了JSON文件本身,使用-d標誌。

此操作的響應結果如下:

{"ok":true,"id":"803da996e1524591ce773d24400004ff","rev":"1-2fc1d70532433c39c9f61480607e3681"}

此響應的部分"ok":true表示操作成功。 響應包括分別代表文件ID和文件修訂的欄位id和rev。 需要修改或刪除此文件時,才需要這兩個欄位。

在此範例中,文件ID由CouchDB生成,因為沒有提供該命令。 如果需要,可以建立一個具有生成唯一ID的文件。

用指定的ID建立

建立一個ID為random_task的文件:

curl -X POST -d '{"_id":"random_task", "todo":"task 2", "done":false}' http://localhost:5984/new_database -H "Content-Type:application/json"

此命令建立一個ID為random_task的新文件,對此命令的響應如下:

{"ok":true,"id":"random_task","rev":"1-bceeae3c4a9154c87db1649473316e44"}

建立多個文件

除了建立單個文件,還可以批次建立文件。

curl -X POST -d '{"docs": [{"todo":"task 3", "done":false}, {"todo":"task 4", "done":false}]}' http://localhost:5984/new_database/_bulk_docs -H "Content-Type:application/json"

該命令將在POST正文中指定建立兩個文件。 與單個文件插入相比,有兩個微小的差異:

  1. 在插入單個文件時,POST正文只是一個標準的JSON物件。 在批次插入的情況下,POST正文包含具有文件欄位的物件。 該欄位儲存要插入的文件陣列。

  2. 在插入單個文件時,POST請求已傳送到指向資料庫的URL(http://localhost:5984/new_database)。 但是,對批次插入請求,URL為:URL:http://localhost:5984/new_database/_bulk_docs。

批次插入操作的響應如下:

[{"ok":true,"id":"803da996e1524591ce773d24400007df","rev":"1-778fd61f8f460d0c1df1bb174279489d"},{"ok":true,"id":"803da996e1524591ce773d2440001723","rev":"1-dc9e84861bba58e5cfefeed8f5133636"}]

讀取檔案

可通過發出HTTP GET命令來從CouchDB資料庫檢索文件。現在嘗試檢索上面建立的一個文件:一個叫random_task的檔案。

curl -X GET http://localhost:5984/new_database/random_task

請注意,URL包括正在檢索的文件的ID(random_task)。如下所示,對此GET請求的響應包含整個文件以及_id和_rev欄位,可用於更新或刪除此文件。

{"_id":"random_task","_rev":"1-bceeae3c4a9154c87db1649473316e44","todo":"task 2","done":false}

更新文件

在要更新文件時,包含_rev欄位很重要。 CouchDB將拒絕任何不包含_rev欄位的更新請求。 由於CouchDB更新整個文件,而不僅僅是其中的一部分,所以在更新操作期間,必須在請求正文中傳送整個文件。

要更新使用ID為random_task的文件,我們需要發出HTTP PUT請求,如下所示:

curl -X PUT -d '{"_rev":"1-bceeae3c4a9154c87db1649473316e44", "todo":"task 2", "done":true}' http://localhost:5984/new_database/random_task

因為每個_rev值可能不太一樣,所以請確保將_rev值替換為上一個輸出中接收到的字串。

這將修改文件並將done欄位更新為true。 對此請求的響應如下:

{"ok":true,"id":"random_task","rev":"2-4cc3dfb6e76befd665faf124b36b7f1c"}

從響應中可以看出,該指定文件的rev欄位在更新後會發生更改。 任何將來更新或刪除此文件的請求現在都必須使用最新的rev值。

刪除文件

使用HTTP DELETE請求要指定包含這個新的rev值來刪除這個文件,如下所示:

curl -X DELETE http://localhost:5984/new_database/random_task?rev=2-4cc3dfb6e76befd665faf124b36b7f1c

就像上面的GET&PUT請求一樣,DELETE請求使用指向文件的URL。但是,它還包括URL中的附加查詢引數。 該引數rev應具有刪除操作成功的最新_rev值。

在這種特殊情況下,使用上一步中更新操作後返回的值。 對上述請求的響應如下所示。

{"ok":true,"id":"random_task","rev":"3-07d6cde68be2a559497ec263045edc9d"}

重新啟動,停止和啟動CouchDB服務

啟動,停止和重新啟動CouchDB服務是非常簡單的。下面我們來看看如何從伺服器完成這些步驟。

重新啟動CouchDB

要重新啟動正在執行的CouchDB範例,請執行以下命令:

$ sudo restart couchdb

此命令將重新啟動正在執行的CouchDB範例並顯示新範例的進程ID。如果沒有CouchDB的範例執行,執行該命令會給出一個訊息:

$ restart: Unknown instance:

停止CouchDB

要停止執行的CouchDB範例,請執行以下命令:

$ sudo stop couchdb

執行此命令將停止任何正在執行的CouchDB範例,並提供如下所示的確認訊息:

$ couchdb stop/waiting

啟動CouchDB

要啟動CouchDB,請執行以下命令:

$ sudo start couchdb

如果CouchDB尚未執行,則執行此命令將啟動CouchDB並提供如下所示的確認訊息:

$ couchdb start/running, process 12345

如果有CouchDB範例已經執行,那麼執行上面的命令就會產生一個這樣的訊息:

$ start: Job is already running: couchdb

CouchDB狀態

如果想檢視CouchDB的狀態,可以使用以下命令:

$ sudo status couchdb

如果CouchDB正在執行,則會提供類似於以下內容的訊息:

$ couchdb start/running, process 12345

如果CouchDB沒有執行,檢視狀態將提示訊息如下:

couchdb stop/waiting

結束

您現在可以在伺服器上使用CouchDB的所有功能了,可以使用Futon或命令列從本地機器安全地管理CouchDB。

最後宣告:對伸手黨,需要注意的是:本教學包教不包會。