Veritabanlarını yönetme

Bu sayfada, 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 izole etmek ve verileri bölgeselleştirmek için birden fazla veritabanı kullanabilirsiniz.

Gerekli roller ve izinler

Veritabanı oluşturmak ve yönetmek için aşağıdaki Identity and Access Management rolüne sahip olmanız gerekir:

• Cloud Datastore Sahibi (roles/datastore.owner)

Bu rol, veritabanı oluşturmak ve yönetmek için gereken aşağıdaki izinleri verir:

• 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

Veritabanı oluşturmak için aşağıdaki yöntemlerden birini kullanın:

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
}

Veritabanı kimliği

Geçerli bir veritabanı kimliği şu kurallara uygun olmalıdır:

• Yalnızca harf, sayı ve kısa çizgi (-) karakterleri içermelidir.
• 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.

Bu kuralların bir istisnası vardır: Standard sürüm, kendiniz bir kimlik girmezseniz (default) adlı bir veritabanı oluşturur.

Bir veritabanını sildikten sonra kimliğini yaklaşık 5 dakika boyunca yeniden kullanamayacağınızı unutmayın.

Korumayı silme

Bir veritabanının yanlışlıkla silinmesini önlemek için silme korumasını kullanın. Silme koruması etkin olan bir veritabanını, silme korumasını devre dışı bırakmadan silemezsiniz. Silme koruması varsayılan olarak devre dışıdır. Silme korumasını etkinleştirmek veya devre dışı bırakmak için veritabanı yapılandırmasını güncelleyebilirsiniz.

Veritabanlarınız için Cloud Firestore Security Rules ayarlarını yapma

Cloud Firestore Security Rules kurallarını veritabanlarınızın her birine dağıtmak için Firebase CLI'yı kullanın. Cloud Firestore Security Rules uygulamasını yönetme ve dağıtma kılavuzuna bakın.

İstemci kitaplığıyla adlandırılmış bir veritabanına erişme

Adlandırılmış veritabanı, (default) olarak adlandırılmamış tüm veritabanlarını içerir. Varsayılan olarak Firebase SDK'ları ve Google API istemci kitaplıkları, bir projedeki (default) Cloud Firestore veritabanına bağlanır. Adlandırılmış bir veritabanına bağlı istemci oluşturmak için istemciyi örneklendirirken veritabanı kimliğini ayarlayın.

Veritabanlarını listeleme

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

gcloud firestore databases list

firebase 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

firebase firestore:databases:get DATABASE_ID

DATABASE_ID yerine bir veritabanı kimliği girin.

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ı 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 --delete-protection işaretiyle gcloud firestore databases update komutunu 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 --no-delete-protection işaretiyle birlikte gcloud firestore databases update komutunu kullanın. Örneğin:

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

DATABASE_ID yerine bir veritabanı kimliği girin.

Veritabanı silme

Veritabanını silmek için konsolu veya komut satırı aracını kullanın.

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

Veritabanında App Engine arama verileri veya blob varlıkları varsa önce bu verileri silmeniz gerekir.

Bir veritabanını sildiğinizde, o veritabanının Eventarc tetikleyicileri otomatik olarak silinmez. Tetikleyici, etkinlik yayınlamayı durdurur ancak siz tetikleyiciyi silene kadar var olmaya devam eder.

Veritabanı silme işlemlerinden ücret alınmaz.

gcloud firestore databases delete --database=DATABASE_ID

Veritabanı klonlama

Mevcut bir veritabanını, seçilen bir zaman damgasında yeni bir veritabanına kopyalayabilirsiniz:

• Klonlanan veritabanı, kaynak veritabanıyla aynı konumda oluşturulacak 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.

• Klonlanan veritabanı, varsayılan olarak Google'ın varsayılan şifrelemesi veya CMEK şifrelemesi kullanılarak kaynak veritabanıyla aynı şekilde şifrelenir. CMEK şifrelemesi için farklı bir şifreleme türü belirtebilir veya 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:

  • Veritabanınız için PITR etkinleştirilmişse son 7 gün içindeki herhangi bir dakikayı seçebilirsiniz (PITR 7 günden daha kısa bir süre önce etkinleştirildiyse daha az).
  • PITR etkinleştirilmemişse son bir saatteki herhangi bir dakikayı seçebilirsiniz.
  • Seçebileceğiniz en erken zaman damgasını veritabanınızın açıklamasında görebilirsiniz.

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'

Veritabanı bazında erişim izinlerini yapılandırma

Erişim izinlerini veritabanı düzeyinde yapılandırmak için Identity and Access Management 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ılmıştır. 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 değerini proje kimliğiniz olarak ayarlayın.

Bir 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 Google Hesabı'nı 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 Google Hesabı'nı 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 Google Hesabı'nı temsil eden e-posta adresi. Örneğin, alice@example.com.

Cloud Monitoring

Cloud Firestore metrikleri, iki izlenen kaynak altında raporlanır.

• firestore.googleapis.com/Database
• firestore_instance(Eski)

firestore.googleapis.com/Database tablosuna bakarak veritabanı düzeyindeki toplu metrikleri inceleyebilirsiniz. firestore_instance altında raporlanan metrikler, proje düzeyinde toplanır.

Sınırlamalar

• Proje başına en fazla 100 veritabanınız olabilir. Bu sınırın artırılmasını talep etmek için destek ekibiyle iletişime geçebilirsiniz.
• GAE arama verileri içeriyorsa (default) veritabanınızı silemezsiniz. GAE arama verilerini silmek için index delete API'yi kullanın. GAE Search verilerini yakın zamanda sildiyseniz veritabanını silebilmeniz için bir bekleme süresi olabilir.
• Blob varlıkları içeriyorsa (default) veritabanınızı silemezsiniz. Blobstore verilerini silmek için Blobstore silme API'sini kullanın. Google Cloud Console'da şu GQL sorgusunu çalıştırarak (default) veritabanınızda Blobstore verileri olup olmadığını kontrol edebilirsiniz: SELECT * FROM __BlobInfo__.
• Silme işlemi gerçekleştikten sonra 5 dakika geçene kadar veritabanı kimliğini yeniden kullanamazsınız.
• Cloud Functions işlevi v1, Firestore adlandırılmış veritabanlarını desteklemez. Adlandırılmış veritabanları için etkinlikleri yapılandırmak üzere Cloud Firestore Tetikleyicileri'ni (2. nesil) kullanın.
• Veritabanı silindikten sonra, aynı ada sahip yeni bir veritabanı oluşturulsa bile Firestore işlev tetikleyicileri v1 ve Firestore etkinlik tetikleyicileri çalışmayı durdurabilir.

Sırada ne var?

• Veri ekleme
• Veri alma
• Verileri silme