จัดการฐานข้อมูล

หน้านี้อธิบายวิธีสร้าง อัปเดต และลบฐานข้อมูล Cloud Firestore คุณสร้างฐานข้อมูล Cloud Firestore ได้หลายฐานข้อมูลต่อโปรเจ็กต์ คุณสามารถใช้ฐานข้อมูลหลายรายการเพื่อตั้งค่าสภาพแวดล้อมการใช้งานจริงและการทดสอบ เพื่อแยกข้อมูลลูกค้า และเพื่อการจัดระเบียบข้อมูลตามภูมิภาค

บทบาทและสิทธิ์ที่จำเป็น

หากต้องการสร้างและจัดการฐานข้อมูล คุณจะต้องมีบทบาท Identity and Access Management ต่อไปนี้

• เจ้าของ Cloud Datastore (roles/datastore.owner)

บทบาทดังกล่าวจะให้สิทธิ์ต่อไปนี้ซึ่งคุณต้องใช้ในการสร้างและจัดการฐานข้อมูล

• สร้างฐานข้อมูล: datastore.databases.create
• อ่านการกำหนดค่าฐานข้อมูล: datastore.databases.getMetadata
• กำหนดค่าฐานข้อมูล: datastore.databases.update
• ลบฐานข้อมูล: datastore.databases.delete
• โคลนฐานข้อมูล: datastore.databases.clone

สร้างฐานข้อมูล

หากต้องการสร้างฐานข้อมูล ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้

firebase firestore:databases:create DATABASE_ID \n--location=LOCATION \n[--edition EDITION] \n[--firestore-data-access FIRESTORE_ACCESS] \n[--realtime-updates REALTIME_UPDATES] \n[--delete-protection DELETE_PROTECTION_ENABLEMENT]

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

รหัสฐานข้อมูล

รหัสฐานข้อมูลที่ถูกต้องต้องเป็นไปตามกฎต่อไปนี้

• มีได้เฉพาะตัวอักษร ตัวเลข และอักขระขีดกลาง (-) เท่านั้น
• ตัวอักษรต้องเป็นตัวพิมพ์เล็ก
• อักขระตัวแรกต้องเป็นตัวอักษร
• อักขระสุดท้ายต้องเป็นตัวอักษรหรือตัวเลข
• มีอักขระอย่างน้อย 4 ตัว
• มีอักขระได้สูงสุด 63 ตัว
• ต้องไม่ใช่ UUID หรือคล้ายกับ UUID เช่น อย่าใช้รหัสอย่าง f47ac10b-58cc-0372-8567-0e02b2c3d479

มีข้อยกเว้น 1 ข้อสำหรับกฎเหล่านี้คือ รุ่น Standard จะสร้างฐานข้อมูลชื่อ (default) หากคุณไม่ได้ป้อนรหัสด้วยตนเอง

โปรดทราบว่าหลังจากลบฐานข้อมูลแล้ว คุณจะใช้รหัสของฐานข้อมูลนั้นซ้ำไม่ได้เป็นเวลาประมาณ 5 นาที

ลบการปกป้อง

ใช้การป้องกันการลบเพื่อป้องกันการลบฐานข้อมูลโดยไม่ตั้งใจ คุณจะลบฐานข้อมูลที่เปิดใช้การป้องกันการลบไม่ได้จนกว่าจะปิดใช้การป้องกันการลบ การป้องกันการลบจะปิดอยู่โดยค่าเริ่มต้น คุณสามารถอัปเดตการกำหนดค่าฐานข้อมูลเพื่อเปิดหรือปิดใช้การป้องกันการลบได้

ตั้งค่า Cloud Firestore Security Rules สำหรับฐานข้อมูล

ใช้ Firebase CLI เพื่อติดตั้งใช้งาน Cloud Firestore Security Rules ในฐานข้อมูลแต่ละรายการ โปรดดูคำแนะนำในการจัดการและติดตั้งใช้งาน Cloud Firestore Security Rules

เข้าถึงฐานข้อมูลที่มีชื่อด้วยไลบรารีของไคลเอ็นต์

ฐานข้อมูลที่มีชื่อรวมถึงฐานข้อมูลที่ไม่ได้ชื่อ (default) โดยค่าเริ่มต้น Firebase SDK และไลบรารีของไคลเอ็นต์ Google API จะเชื่อมต่อกับฐานข้อมูล (default) Cloud Firestore ในโปรเจ็กต์ หากต้องการสร้างไคลเอ็นต์ที่เชื่อมต่อกับฐานข้อมูลที่มีชื่อ ให้ตั้งค่ารหัสฐานข้อมูลเมื่อสร้างอินสแตนซ์ไคลเอ็นต์

แสดงรายการฐานข้อมูล

ใช้วิธีใดวิธีหนึ่งต่อไปนี้เพื่อแสดงรายการฐานข้อมูล

gcloud firestore databases list

firebase firestore:databases:list

ดูรายละเอียดฐานข้อมูล

หากต้องการดูรายละเอียดเกี่ยวกับฐานข้อมูลเดียว ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

แทนที่ DATABASE_ID ด้วยรหัสฐานข้อมูล

อัปเดตการกำหนดค่าฐานข้อมูล

หากต้องการอัปเดตการตั้งค่าการกำหนดค่าของฐานข้อมูล ให้ใช้คำสั่ง gcloud firestore databases update ใช้คำสั่งนี้เพื่อเปลี่ยนเป็นเปิดหรือปิดใช้การป้องกันการลบ

อัปเดตการตั้งค่าการป้องกันการลบ

หากต้องการเปิดใช้การป้องกันการลบในฐานข้อมูล ให้ใช้คำสั่ง gcloud firestore databases update กับแฟล็ก --delete-protection เช่น

gcloud firestore databases update --database=DATABASE_ID --delete-protection

แทนที่ DATABASE_ID ด้วยรหัสฐานข้อมูล

หากต้องการปิดใช้การป้องกันการลบในฐานข้อมูล ให้ใช้คำสั่ง gcloud firestore databases update กับแฟล็ก --no-delete-protection เช่น

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

แทนที่ DATABASE_ID ด้วยรหัสฐานข้อมูล

ลบฐานข้อมูล

หากต้องการลบฐานข้อมูล ให้ใช้คอนโซลหรือเครื่องมือบรรทัดคำสั่ง

หากฐานข้อมูลเปิดใช้การตั้งค่าการป้องกันการลบ คุณต้องปิดใช้การป้องกันการลบก่อน

หากฐานข้อมูลมีข้อมูลการค้นหา App Engine หรือเอนทิตี Blob คุณต้องลบข้อมูลดังกล่าวก่อน

การลบฐานข้อมูลจะไม่ลบทริกเกอร์ Eventarc สำหรับฐานข้อมูลนั้นโดยอัตโนมัติ ทริกเกอร์จะหยุดส่งเหตุการณ์ แต่จะยังคงอยู่จนกว่าคุณจะลบทริกเกอร์

การลบฐานข้อมูลจะไม่ทำให้เกิดค่าใช้จ่ายสำหรับการดำเนินการลบ

gcloud firestore databases delete --database=DATABASE_ID

โคลนฐานข้อมูล

คุณสามารถโคลนฐานข้อมูลที่มีอยู่ ณ การประทับเวลาที่เลือกไว้ลงในฐานข้อมูลใหม่ได้โดยทำดังนี้

• ฐานข้อมูลที่โคลนคือฐานข้อมูลใหม่ที่จะสร้างขึ้นในตำแหน่งเดียวกับฐานข้อมูลต้นทาง

  ในการสร้างโคลน Cloud Firestore จะใช้ข้อมูลการกู้คืนช่วงเวลา (PITR) ของฐานข้อมูลต้นทาง ฐานข้อมูลที่โคลนจะมีข้อมูลและดัชนีทั้งหมด

• โดยค่าเริ่มต้น ฐานข้อมูลที่โคลนจะได้รับการเข้ารหัสในลักษณะเดียวกับฐานข้อมูลต้นทาง โดยใช้การเข้ารหัสเริ่มต้นของ Google หรือการเข้ารหัส CMEK คุณสามารถระบุประเภทการเข้ารหัสอื่นหรือใช้คีย์อื่นสำหรับการเข้ารหัส CMEK ได้

• การประทับเวลามีความละเอียด 1 นาทีและระบุจุดเวลาในอดีตในช่วงเวลาที่กำหนดโดยกรอบเวลา PITR ดังนี้

  • หากเปิดใช้ PITR สำหรับฐานข้อมูล คุณจะเลือกนาทีใดก็ได้ในช่วง 7 วันที่ผ่านมา (หรือน้อยกว่านั้นหากเปิดใช้ PITR น้อยกว่า 7 วันที่ผ่านมา)
  • หากไม่ได้เปิดใช้ PITR คุณจะเลือกนาทีใดก็ได้ในชั่วโมงที่ผ่านมา
  • คุณสามารถตรวจสอบการประทับเวลาที่เร็วที่สุดที่เลือกได้ในคำอธิบายของฐานข้อมูล

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

กำหนดค่าสิทธิ์การเข้าถึงต่อฐานข้อมูล

คุณสามารถใช้เงื่อนไข Identity and Access Management เพื่อกำหนดค่าสิทธิ์การเข้าถึงในระดับฐานข้อมูลแต่ละรายการได้ ตัวอย่างต่อไปนี้ใช้ Google Cloud CLI เพื่อกำหนดการเข้าถึงแบบมีเงื่อนไขสำหรับฐานข้อมูลอย่างน้อย 1 รายการ นอกจากนี้ คุณยังกำหนดเงื่อนไข IAM ในคอนโซล Google Cloud ได้ด้วย

ดูนโยบาย IAM ที่มีอยู่

gcloud projects get-iam-policy PROJECT_ID

ตั้งค่า PROJECT_ID เป็นรหัสโปรเจ็กต์

ให้สิทธิ์เข้าถึงฐานข้อมูล

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

ตั้งค่าต่อไปนี้

• PROJECT_ID: รหัสโปรเจ็กต์ของคุณ
• EMAIL: อีเมลที่แสดงถึงบัญชี Google ที่เฉพาะเจาะจง เช่น alice@example.com
• DATABASE_ID: รหัสฐานข้อมูล
• TITLE: ชื่อที่ไม่บังคับสำหรับนิพจน์
• DESCRIPTION: คำอธิบายที่ไม่บังคับของนิพจน์

ให้สิทธิ์เข้าถึงฐานข้อมูลทั้งหมดยกเว้นฐานข้อมูลเดียว

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

ตั้งค่าต่อไปนี้

• PROJECT_ID: รหัสโปรเจ็กต์ของคุณ
• EMAIL: อีเมลที่แสดงถึงบัญชี Google ที่เฉพาะเจาะจง เช่น alice@example.com
• DATABASE_ID: รหัสฐานข้อมูล
• TITLE: ชื่อที่ไม่บังคับสำหรับนิพจน์
• DESCRIPTION: คำอธิบายที่ไม่บังคับของนิพจน์

นำนโยบายสำหรับสมาชิกและบทบาทที่ระบุออก

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

ตั้งค่าต่อไปนี้

• PROJECT_ID: รหัสโปรเจ็กต์ของคุณ
• EMAIL: อีเมลที่แสดงถึงบัญชี Google ที่เฉพาะเจาะจง เช่น alice@example.com

Cloud Monitoring

ระบบจะรายงานเมตริก Cloud Firestore รายการภายใต้ทรัพยากรที่มีการตรวจสอบ 2 รายการ

• firestore.googleapis.com/Database
• firestore_instance(เดิม)

คุณตรวจสอบเมตริกแบบรวมที่ระดับฐานข้อมูลได้โดยดูที่ firestore.googleapis.com/Database เมตริกที่รายงานในส่วน firestore_instance จะรวบรวมไว้ที่ระดับโปรเจ็กต์

ข้อจำกัด

• คุณมีฐานข้อมูลได้สูงสุด 100 รายการต่อโปรเจ็กต์ คุณสามารถติดต่อทีมสนับสนุนเพื่อขอเพิ่มขีดจำกัดนี้ได้
• คุณไม่สามารถลบฐานข้อมูล (default) หากมีข้อมูลการค้นหา GAE อยู่ ใช้ index delete api เพื่อลบข้อมูลการค้นหา GAE หากคุณเพิ่งลบข้อมูล GAE Search คุณอาจต้องรอสักระยะก่อนที่จะลบฐานข้อมูลได้
• คุณไม่สามารถลบฐานข้อมูล (default) หากมีเอนทิตี Blob อยู่ ใช้ Blobstore delete api เพื่อลบข้อมูล Blobstore คุณตรวจสอบได้ว่าฐานข้อมูล (default) มีข้อมูล Blobstore หรือไม่โดยเรียกใช้การค้นหา GQL ต่อไปนี้ในคอนโซล Google Cloud: SELECT * FROM __BlobInfo__
• คุณจะใช้รหัสฐานข้อมูลซ้ำไม่ได้จนกว่าจะผ่านไป 5 นาทีหลังจากลบ
• Cloud Function v1 ไม่รองรับฐานข้อมูลที่มีชื่อของ Firestore ใช้ทริกเกอร์ Cloud Firestore (รุ่นที่ 2) เพื่อกำหนดค่าเหตุการณ์สำหรับฐานข้อมูลที่ตั้งชื่อ
• ทริกเกอร์ฟังก์ชัน Firestore v1 และทริกเกอร์เหตุการณ์ Firestore อาจหยุดทำงานหลังจากลบฐานข้อมูล แม้ว่าจะสร้างฐานข้อมูลใหม่โดยใช้ชื่อเดียวกันก็ตาม

ขั้นตอนถัดไป

• เพิ่มข้อมูล
• รับข้อมูล
• ลบข้อมูล