Veritabanlarını yönetme

Bu sayfada Cloud Firestore veri tabanları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ını ayarlamak, müşteri verilerini izole etmek ve verilerin bölgeselleştirilmesi için birden fazla veritabanı kullanabilirsiniz.

(default) veritabanı

Uygulamanız birden fazla veritabanı gerektirmiyorsa (default) veritabanını kullanın.

Veritabanı belirtmezseniz Cloud Firestore istemci kitaplıkları ve Google Cloud CLI varsayılan olarak (default) veritabanına bağlanır.

Gerekli roller

Veritabanları oluşturmak ve yönetmek için Owner veya Datastore Owner Identity and Access Management rolüne sahip olmanız gerekir. Bu roller, gerekli izinleri verir.

Gerekli izinler

Veritabanlarını yönetmek için aşağıdaki izinlere ihtiyacınız vardır:

• Veritabanı oluşturun: datastore.databases.create
• Veritabanı yapılandırmasını okuma: datastore.databases.getMetadata
• Bir veritabanı yapılandırın: datastore.databases.update
• Veritabanı silme: datastore.databases.delete

Veritabanı oluşturun

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

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--type=DATABASE_TYPE \
[--delete-protection]

firebase firestore:databases:create DATABASE_ID \
--location=LOCATION \
[--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 veritabanı kimlikleri arasında (default) ve aşağıdakilere uygun kimlikler bulunur:

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

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

Korumayı sil

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

Veritabanlarınız için Cloud Firestore Güvenlik Kurallarını ayarlama

Cloud Firestore Güvenlik Kurallarını veritabanlarınızın her birine dağıtmak için Firebase CLI'ı kullanın. Cloud Firestore Güvenlik Kuralları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ında (default) adında olmayan veritabanları bulunur. Firebase SDK'ları ve Google API İstemci Kitaplıkları varsayılan olarak bir projedeki (default) Cloud Firestore veritabanına bağlanır. Adlandırılmış bir veritabanına bağlı bir istemci oluşturmak için bir istemci örneği oluştururken 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öster

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 değerini bir veritabanı kimliğiyle değiştirin.

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 birlikte gcloud firestore databases update komutunu kullanın. Örnek:

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

DATABASE_ID değerini bir veritabanı kimliğiyle değiştirin.

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. Örnek:

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

DATABASE_ID değerini bir veritabanı kimliğiyle değiştirin.

Veritabanı silme

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

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

Veritabanı, App Engine arama verileri veya blob varlıkları içeriyorsa önce bu verileri silmeniz gerekir.

Bir veritabanının silinmesi, o veritabanına ait herhangi bir Eventarc tetikleyicisinin otomatik olarak silinmesine neden olmaz. Tetikleyici, etkinlikleri yayınlamayı durdurur ancak siz tetikleyici silene kadar var olmaya devam eder.

gcloud firestore databases delete --database=DATABASE_ID

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

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

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

gcloud projects get-iam-policy PROJECT_ID

PROJECT_ID öğesini proje kimliğinize ayarlayı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 Google Hesabı'nı temsil eden e-posta adresidir. Örneğin, alice@example.com.
• DATABASE_ID: veritabanı kimliği.
• TITLE: İfade için isteğe bağlı bir başlık.
• DESCRIPTION: ifadenin isteğe bağlı bir açıklamasıdır.

Bir veritabanı hariç tümüne erişim izni ver

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 adresidir. Örneğin, alice@example.com.
• DATABASE_ID: veritabanı kimliği.
• TITLE: İfade için isteğe bağlı bir başlık.
• DESCRIPTION: ifadenin isteğe bağlı bir açıklamasıdır.

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 adresidir. Örneğin, alice@example.com.

Cloud Monitoring

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

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

firestore.googleapis.com/Database adresinden toplu metrikleri veritabanı düzeyinde 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ı istemek için destek ekibiyle iletişime geçebilirsiniz.
• GAE arama verileri içeriyorsa (default) veritabanınızı silemezsiniz. GAE arama verilerini silmek için lütfen index delete API'yi kullanın. GAE Arama verilerini yakın zamanda sildiyseniz veritabanını silebilmeniz için bir bekleme süresi gerekebilir.
• Blob varlıkları içeriyorsa (default) veritabanınızı silemezsiniz. Blobstore verilerini silmek için lütfen Blobstore delete api'yi kullanın. (default) veritabanınızın Blobstore verileri içerip içermediğini Google Cloud Platform Console'da şu GQL sorgusunu çalıştırarak kontrol edebilirsiniz: SELECT * FROM __BlobInfo__.
• Silme işleminin üzerinden 5 dakika geçene kadar veritabanı kimliğini yeniden kullanamazsınız.
• Cloud Function v1, Firestore Adlandırılmış veritabanlarını desteklemez. Adlandırılmış veritabanlarıyla ilgili etkinlikleri yapılandırmak için lütfen Cloud Firestore Tetikleyicilerini (2. Nesil) kullanın.
• Aynı adla yeni bir veritabanı oluşturulmuş olsa bile, veritabanı silindikten sonra Firestore işlevi tetikleyicileri v1 ve Firestore etkinlik tetikleyicileri çalışmayı durdurabilir.

Sırada ne var?

• Veri ekleme
• Veri alma
• Verileri silme