สร้างทรัพยากร

เสร็จสมบูรณ์เมื่อ

เมื่อจัดการ Azure Cosmos DB สําหรับบัญชี NoSQL โดยใช้ Azure CLI คําสั่งส่วนใหญ่จะแบ่งเป็นกลุ่มคําสั่ง CLI สองกลุ่มหลัก:

• az cosmosdb: กลุ่มนี้ประกอบด้วยคําสั่งที่จําเป็นในการสร้างและจัดการบัญชี Azure Cosmos DB ใหม่
• az cosmosdb sql: กลุ่มย่อยนี้ของกลุ่ม az cosmosdb กลุ่มประกอบด้วยคําสั่งเพื่อจัดการทรัพยากรเฉพาะ NoSQL API เช่นฐานข้อมูลและคอนเทนเนอร์

คําสั่งกลุ่มบัญชี Azure Cosmos DB

เมื่อต้องสร้างบัญชีใหม่ คุณจะต้องใช้ az cosmosdb สร้างคําสั่ง คําสั่งนี้ต้องการเพียงชื่อของบัญชีใหม่เพื่อสร้างและกลุ่มทรัพยากรเป้าหมายสําหรับทรัพยากรบัญชีเป็นอย่างน้อย เมื่อสร้างบัญชีใหม่ คุณต้องแน่ใจว่า ชื่อที่คุณใช้อยู่ทั่วโลกไม่ซ้ํากันเพื่อหลีกเลี่ยงล้มเหลวของคําสั่งเนื่องจากความขัดแย้งของชื่อกับอินสแตนซ์บริการอื่น

เคล็ดลับ

ตามค่าเริ่มต้น คําสั่งนี้จะสร้างบัญชี NoSQL ใหม่

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>'

เมื่อสร้างบัญชีใหม่ คุณสามารถเลือกที่จะระบุพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะของบัญชีที่สร้างขึ้นใหม่ได้ ตัวอย่างเช่น คําสั่งนี้เปิดใช้งานระดับฟรีและตั้งค่าระดับความสอดคล้องกันเริ่มต้นเป็น Eventual

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --default-consistency-level 'Eventual' \
    --enable-free-tier 'true'

ในกรณีส่วนใหญ่ คุณจะต้องระบุภูมิภาคที่คุณต้องการปรับใช้บัญชี Azure Cosmos DB ของคุณ คุณสามารถใช้อาร์กิวเมนต์ --locations เพื่อระบุตําแหน่งที่ตั้งเป้าหมายอย่างน้อยหนึ่งรายการสําหรับบัญชีของคุณ

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --locations regionName='eastus'

หลังจากนั้น คุณจะได้เรียนรู้วิธีการระบุตําแหน่งที่ตั้งเป้าหมายหลายรายการในขณะที่ตั้งค่าลําดับความสําคัญการเฟลโอเวอร์ที่เหมาะสมสําหรับแต่ละตําแหน่งที่ตั้ง

หมายเหตุ

เมื่อมีข้อสงสัย คุณสามารถค้นหาเอกสารวิธีใช้สําหรับคําสั่งได้เสมอโดยใช้อาร์กิวเมนต์ --help ในตัวอย่างเหล่านี้: az cosmosdb --help & az cosmosdb create --help

Azure Cosmos DB สําหรับคําสั่งกลุ่มย่อย NoSQL

กลุ่มคําสั่ง az cosmosdb sql มีคําสั่งและกลุ่มย่อยหลายรายการเพื่อจัดการทรัพยากรแต่ละรายการภายใน NoSQL API ตัวอย่างเช่น คุณสามารถใช้ฐานข้อมูล az cosmosdb sql สร้างคําสั่ง เพื่อสร้างฐานข้อมูลใหม่ภายในบัญชีที่มีอยู่ ในตัวอย่างนี้ อาร์กิวเมนต์ --name อ้างอิงถึงชื่อของฐานข้อมูลใหม่ และอาร์กิวเมนต์ --account-name อ้างอิงถึงชื่อของบัญชีที่สร้างขึ้นก่อนหน้านี้

az cosmosdb sql database create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --name '<database-name>' 

คอนเทนเนอร์ sql az cosmosdb สร้างคําสั่ง สร้างคอนเทนเนอร์ใหม่ภายในฐานข้อมูลที่มีอยู่ อาร์กิวเมนต์ --name ในบริบทนี้อ้างอิงถึงชื่อของคอนเทนเนอร์ใหม่ ในขณะที่อาร์กิวเมนต์ ชื่อฐานข้อมูล อ้างอิงถึงชื่อของฐานข้อมูลที่สร้างขึ้นก่อนหน้านี้

คําสั่งการสร้างนี้จําเป็นต้องมีอย่างน้อยที่สุด ค่าสําหรับอาร์กิวเมนต์ --partition-key-key-path เนื่องจากอาร์กิวเมนต์นี้จําเป็นสําหรับคอนเทนเนอร์ทั้งหมดใน Azure Cosmos DB สําหรับ NoSQL

az cosmosdb sql container create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --database-name '<database-name>' \
    --name '<container-name>' \
    --throughput '400' \
    --partition-key-path '<partition-key-path-string>'

หมายเหตุ

เมื่อมีข้อสงสัย คุณสามารถค้นหาเอกสารวิธีใช้สําหรับคําสั่งได้เสมอโดยใช้อาร์กิวเมนต์ --help ในตัวอย่างเหล่านี้: az cosmosdb sql --help, az cosmosdb sql database --help, & az cosmosdb sql container --help