Azure DocumentDB - Part 2 (建立 DocumentDB Collection)

要使用 Microsoft Azure DocumentDB，必須建立 DocumentDB Account、database、Collection和Document, 前面已建立過 DocumentDB Account，接著就是來建立 Collection(為什麼好像跳過 database ?! 因為畫面上沒有可以新增 database 的操作介面 ，在建立 Collection 的設定時可以一併新增)

什麼是 DocumentDB Collection

• 用來儲存 json 檔案 和 JavaScript 應用程式邏輯的容器
• 實際計價的依據，會依部署的傳輸量來收費
• 可以跨一個以上的的伺服器(資料分割)
• 會由 DocumentDB 自動羲割成一個或是多個實體伺服器
• 建立時可以指定每秒要求單位 (RU/s) 及 分割 key 屬性 (partiotion key)
• partiotion key 也是 Stored Procedure 與 Trigger 的交易界限
• 每個 Collection 都有專屬保留傳輸量，不會與相同帳戶其他 Collection 共用
• Collection 與 關聯式資料庫中的資料表不同，不會強制使用結構描述 (schema-free)
• 可以在 Collection 中儲存各種不同結構描述的不同類型文件

建立 DocumentDB Collection 的方式

1. C#,可以參考 C# Collection sample
2. Node.js,可以參考 Node.js Collection sample
3. Python,可以參考 Python Collection sample
4. REST API,可以參考 REST API Collection sample
5. Azure Portal

如何使用 Azure Portal 建立 DocumentDB Collection

1. 選擇要建立 Collection 的 DocumentDB Account

   

2. 加入集合

   

3. 填入 Collection Info

   

4. 集合識別碼

   • 長度需介於 1 至 255 字元間
   • 不能出現 / \ # ?
   • 最後一個字元不得為空白

     

5. 定價層

   • 可自訂集合傳輸量及儲存體大小，詳細資料可以參考 DocumentDB 中的效能等級

     

6. 資料分割模式

   1. 單一分割
      • 保留儲存體 為 10 GB
      • 傳輸量為 400 -10000 RU/s
      • 一個 RU 會對應至讀取 1 KB 文件的傳輸量
   2. 已分割
      • 可調整為處理多個分割不限數量的儲存體(Azure Portal 可設定上限為 250 GB)
      • 傳輸量可以從 10100 RU/s 往上調整(Azure Portal 可設定上限為 250000 RU/s)
      • 以上皆客製 ,請參考 要求增加 DocumentDB 帳戶配額

        
        
        

7. 資料庫

   • database 在這才出現, 可以選擇 建立新項目 或是 使用現有項目
   • 長度需介於 1 至 255 字元間

     
     

在使用 Microsoft Azure DocumentDB，必須建立 DocumentDB Account、database、Collection和Document 的四個步驟中，同一個 UI 中完成了 database、Collection，接下來就是建立 Document

參考資料

1. 如何使用 Azure 入口網站建立 DocumentDB 集合
2. C# Collection sample
3. Node.js Collection sample
4. Python Collection sample
5. REST API Collection sample
6. DocumentDB 中的效能等級
7. 要求增加 DocumentDB 帳戶配額