Veritabanı oluşturma ve yönetme

Bu sayfada, MongoDB uyumlu Cloud Firestore veritabanlarının nasıl oluşturulacağı, güncelleneceği ve silineceği açıklanmaktadır. Proje başına birden fazla Cloud Firestore veritabanı oluşturabilirsiniz. Üretim ve test ortamları oluşturmak, müşteri verilerini yalıtmak ve verileri bölgeselleştirmek için birden fazla veritabanı kullanabilirsiniz.

Ücretsiz katman kullanımı

Cloud Firestore, ücretsiz olarak kullanmaya başlayabileceğiniz bir ücretsiz katman sunar.

Ücretsiz katman, proje başına yalnızca bir Cloud Firestore veritabanı için geçerlidir. Ücretsiz katman veritabanı olmayan bir projede oluşturulan ilk veritabanı ücretsiz katmanı alır. Ücretsiz katmanın uygulandığı veritabanı silinirse oluşturulan bir sonraki veritabanına ücretsiz katman uygulanır.

Başlamadan önce

Veritabanı oluşturmadan önce aşağıdaki işlemleri tamamlamanız gerekir:

1. Henüz yapmadıysanız bir Firebase projesi oluşturun: Firebase konsolunda Proje ekle'yi tıklayın, ardından Firebase projesi oluşturmak veya Firebase hizmetlerini mevcut bir Google Cloud projesine eklemek için ekrandaki talimatları uygulayın.

2. Bir sonraki bölümde açıklandığı gibi uygun kimlik ve erişim yönetimi rollerini atayın.

Gerekli roller

Veritabanı oluşturmak ve yönetmek için Owner veya Datastore Owner Identity and Access Management rolüne ihtiyacınız vardır. Bu roller, gerekli izinleri verir.

Gerekli izinler

Veritabanlarını yönetmek için aşağıdaki izinlere sahip olmanız gerekir:

• Veritabanı oluşturma: datastore.databases.create
• Veritabanı yapılandırmasını okuma: datastore.databases.getMetadata
• Veritabanı yapılandırma: datastore.databases.update
• Veritabanını silme: datastore.databases.delete
• Veritabanı klonlama: datastore.databases.clone

Veritabanı oluşturun

MongoDB uyumlu bir Cloud Firestore veritabanı oluşturmak için aşağıdaki yöntemlerden birini kullanın:

firebase firestore:databases:create --edition EDITION DATABASE_ID \
--location=LOCATION

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise \
--delete-protection

resource "google_firestore_database" "database" {
  name             = "DATABASE_ID"
  location_id      = "LOCATION"
  type             = "FIRESTORE_NATIVE"
  database_edition = "ENTERPRISE"

  // Optional
  delete_protection_state = "DELETE_PROTECTION_STATE"
}

Veritabanı kimliği

Geçerli veritabanı kimlikleri, aşağıdakilere uygun kimlikleri içerir:

• Yalnızca harf, rakam ve kısa çizgi (-) karakterlerini içerir.
• Harfler küçük olmalıdır.
• İlk karakter harf olmalıdır.
• Son karakter harf veya rakam olmalıdır.
• En az 4 karakter olmalıdır.
• Maksimum 63 karakterdir.
• UUID olmamalı veya UUID'ye benzememelidir. Örneğin, f47ac10b-58cc-0372-8567-0e02b2c3d479 gibi bir kimlik kullanmayın.

Bir veritabanını silerseniz 5 dakika geçene kadar veritabanı kimliğini hemen yeniden kullanamazsınız.

Korumayı silme

Veritabanının yanlışlıkla silinmesini önlemek için silme korumasını kullanın. Silme koruması şu şekilde çalışır:

• Silme koruması etkinleştirilmiş bir veritabanını, silme korumasını devre dışı bırakana kadar silemezsiniz.
• Silme koruması varsayılan olarak devre dışıdır.
• Veritabanını oluştururken silme korumasını etkinleştirebilir veya veritabanı yapılandırmasını güncelleyerek silme korumasını etkinleştirebilirsiniz.

Veritabanlarını listeleme

Veritabanlarınızı listelemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore databases list

Veritabanı ayrıntılarını görüntüleme

Tek bir veritabanıyla ilgili ayrıntıları görüntülemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore databases describe --database=DATABASE_ID

Veritabanı yapılandırmasını güncelleme

Bir veritabanının yapılandırma ayarlarını güncellemek için gcloud firestore databases update komutunu kullanın.

Silme korumasını değiştirmek, etkinleştirmek veya devre dışı bırakmak için bu komutu kullanın.

Silme koruması ayarını güncelleme

Bir veritabanında silme korumasını etkinleştirmek için gcloud firestore databases update --delete-protection işaretini içeren komutu kullanın. Örneğin:

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

DATABASE_ID yerine bir veritabanı kimliği girin.

Bir veritabanında silme korumasını devre dışı bırakmak için gcloud firestore databases update --no-delete-protection işaretini kullanarak komutunu kullanın. Örneğin:

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

DATABASE_ID yerine bir veritabanı kimliği girin.

Veritabanını silme

Veritabanını silmek için konsolu veya komut satırı aracını kullanın. Veritabanı silme işlemi için ücret alınmaz.

Veritabanında silme koruması ayarı etkinse önce silme korumasını devre dışı bırakmanız gerekir.

gcloud firestore databases delete --database=DATABASE_ID

Veritabanı klonlama

Seçilen bir zaman damgasında mevcut bir veritabanını yeni bir veritabanına klonlayabilirsiniz:

• Klonlanan veritabanı, kaynak veritabanıyla aynı konumda oluşturulan yeni bir veritabanıdır.

  Klon oluşturmak için Cloud Firestore, kaynak veritabanının belirli bir noktadan önceyi kurtarma (PITR) verilerini kullanır. Klonlanan veritabanı tüm verileri ve dizinleri içerir.

• Varsayılan olarak, klonlanan veritabanı kaynak veritabanı ile aynı şekilde şifrelenir. Bu işlemde Google'ın varsayılan şifrelemesi veya CMEK şifrelemesi kullanılır. Farklı bir şifreleme türü belirtebilir veya CMEK şifrelemesi için farklı bir anahtar kullanabilirsiniz.

• Zaman damgası bir dakikalık ayrıntı düzeyine sahiptir ve PITR penceresi tarafından tanımlanan dönemde geçmişteki bir zaman noktasını belirtir:

  • PITR, veritabanınız için etkinleştirilmişse son 7 gün içindeki herhangi bir dakikayı seçebilirsiniz (veya PITR 7 günden daha kısa bir süre önce etkinleştirilmişse daha kısa bir süre seçebilirsiniz).
  • PITR etkin değilse son saatteki herhangi bir dakikayı seçebilirsiniz.
  • Veritabanınızın açıklamasında seçebileceğiniz en erken zaman damgasını kontrol edebilirsiniz.

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

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

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

Veritabanı başına erişim izinlerini yapılandırma

Veritabanı düzeyinde erişim izinlerini yapılandırmak için Kimlik ve Erişim Yönetimi Koşulları'nı kullanabilirsiniz. Aşağıdaki örneklerde, bir veya daha fazla veritabanı için koşullu erişim atamak üzere Google Cloud CLI kullanılır. Ayrıca Google Cloud Console'da IAM koşulları da tanımlayabilirsiniz.

Mevcut IAM politikalarını görüntüleme

gcloud projects get-iam-policy PROJECT_ID

PROJECT_ID yerine proje kimliğinizi yazın.

Veritabanına erişim izni verme

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'

Aşağıdakileri ayarlayın:

• PROJECT_ID: Proje kimliğiniz
• EMAIL: Belirli bir hesabı temsil eden e-posta adresi. Örneğin, alice@example.com.
• DATABASE_ID: veritabanı kimliği.
• TITLE: İfade için isteğe bağlı bir başlık.
• DESCRIPTION: İfadenin isteğe bağlı açıklaması.

Bir veritabanı hariç tüm veritabanlarına erişim izni verme

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'

Aşağıdakileri ayarlayın:

• PROJECT_ID: Proje kimliğiniz
• EMAIL: Belirli bir hesabı temsil eden e-posta adresi. Örneğin, alice@example.com.
• DATABASE_ID: veritabanı kimliği.
• TITLE: İfade için isteğe bağlı bir başlık.
• DESCRIPTION: İfadenin isteğe bağlı açıklaması.

Belirli bir üye ve rol için politikaları kaldırma

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

Aşağıdakileri ayarlayın:

• PROJECT_ID: Proje kimliğiniz
• EMAIL: Belirli bir hesabı temsil eden e-posta adresi. Örneğin, alice@example.com.

Sınırlamalar

Proje başına en fazla 100 veritabanınız olabilir. Bu sınırın artırılmasını istemek için destek ekibiyle iletişime geçebilirsiniz.

Sırada ne var?

• Hızlı Başlangıç: Veritabanı oluşturma ve veritabanına bağlanma başlıklı hızlı başlangıç kılavuzunu uygulayın.
• Davranış farklılıkları hakkında bilgi edinin.
• Cloud Monitoring MongoDB uyumlu Cloud Firestore metrikleri hakkında bilgi edinin.