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 yalıtmak ve verileri bölgeselleştirmek için birden fazla veritabanı kullanabilirsiniz.

(default) veritabanı

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

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 ihtiyacınız vardır:

• 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ı oluşturun

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

Konsol

1. Firebase konsolunda Firestore Database sayfasına gidin.

   Firestore veritabanına gitme

2. Bu, ilk adlandırılmış veritabanınızsa Veritabanı ekle'yi tıklayın.
3. Aksi takdirde, (varsayılan)'ı ve ardından Veritabanı ekle'yi tıklayın.
4. Veritabanınızı yapılandırın. Bir veritabanı kimliği girin. Bir yer seçin. Veritabanı oluştur'u tıklayın.

gcloud

gcloud firestore databases create komutunu kullanın.

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

Aşağıdakini değiştirin:

• DATABASE_ID: Geçerli bir veritabanı kimliği.
• LOCATION: Cloud Firestore çok bölgeli veya bölge adı.
• DATABASE_TYPE: Native mode için firestore-native veya Datastore mode için datastore-mode.

--delete-protection, silme korumasını etkinleştirmek için isteğe bağlı bir işarettir. Silme koruması etkinleştirilmiş bir veritabanını bu ayarı devre dışı bırakana kadar silemezsiniz. Bu ayar varsayılan olarak devre dışıdır.

Veritabanına etiket eklemek için --tags işaretini kullanın. Örneğin:

• --tags=123/environment=production,123/costCenter=marketing
• --tags=tagKeys/333=tagValues/444

Firebase CLI

firebase firestore:databases:create DATABASE_ID \
--location=LOCATION \
[--delete-protection DELETE_PROTECTION_ENABLEMENT]

Aşağıdakini değiştirin:

• DATABASE_ID: Geçerli bir veritabanı kimliği.
• LOCATION: Cloud Firestore çok bölgeli veya bölge adı.
• DELETE_PROTECTION_ENABLEMENT: ENABLED veya DISABLED.
Oluşturulan veritabanı her zaman Firestore Native modundadır.

--delete-protection , silme korumasını etkinleştirmek için isteğe bağlı bir bağımsız değişkendir. Silme koruması etkinleştirilmiş bir veritabanını bu ayarı devre dışı bırakana kadar silemezsiniz. Bu ayar varsayılan olarak devre dışıdır.

Terraform

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

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

Aşağıdakini değiştirin:

• DATABASE_ID: Geçerli bir veritabanı kimliği.
• LOCATION: Cloud Firestore çok bölgeli veya bölge adı.
• DATABASE_TYPE: Native mode için FIRESTORE_NATIVE veya Datastore mode için DATASTORE_MODE.
• DELETE_PROTECTION_ENABLEMENT: DELETE_PROTECTION_ENABLED veya DELETE_PROTECTION_DISABLED.

delete_protection_state, silme korumasını etkinleştirmek için isteğe bağlı bir bağımsız değişkendir. Silme koruması etkinleştirilmiş bir veritabanını, bu ayarı devre dışı bırakana kadar silemezsiniz. Bu ayar varsayılan olarak devre dışıdır.

Veritabanı kimliği

Geçerli veritabanı kimlikleri arasında (default) ve aşağıdakilere uygun kimlikler yer alır:

• 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ı 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ız için Cloud Firestore Security Rules'ı ayarlama

Firebase CLI'yı kullanarak Cloud Firestore Security Rules'ı her bir veritabanınıza dağıtın. Cloud Firestore Security Rules 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. 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 istemciyi başlattığınızda veritabanı kimliğini ayarlayın.

Not: Birden fazla veritabanıyla çalışmak için Firebase istemci SDK'larını ve Google API istemci kitaplıklarını en son sürüme güncellediğinizden emin olun.

Veritabanlarını listeleme

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

Konsol

Google Cloud Console'da Veritabanları sayfasına gidin.

Veritabanları'na gidin

Not: Veritabanlarınızı Google Cloud Console'da görüntüleyebilir ve listeleyebilirsiniz. (default) veritabanını Google Cloud Console'u kullanarak oluşturabilirsiniz ancak adlandırılmış bir veritabanı oluşturmak için Google Cloud CLI'yı veya başka bir yöntemi kullanmanız gerekir. Veritabanını silmek için Google Cloud KSA'yı kullanın.

gcloud

Projenizdeki tüm veritabanlarını listelemek için gcloud firestore databases list komutunu kullanın.

gcloud firestore databases list

Firebase CLI

Projenizdeki tüm veritabanlarını listelemek için firebase firestore:databases:list komutunu kullanın.

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

gcloud firestore databases describe komutunu kullanın:

gcloud firestore databases describe --database=DATABASE_ID

Firebase CLI

firebase firestore:databases:get komutunu kullanın:

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 gcloud firestore databases update --delete-protection işaretini içeren komutu kullanın. Örneğin:

gcloud

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

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ında silme koruması ayarı etkinse önce silme korumasını devre dışı bırakmanız gerekir.

Veritabanı App Engine arama verileri veya blob öğeleri içeriyorsa önce bu verileri silmeniz gerekir.

Bir veritabanının silinmesi, o veritabanı için Eventarc tetikleyicileri otomatik olarak silmez. Tetikleyici, etkinlikleri yayınlamayı durdurur ancak siz tetikleyiciyi silene kadar varlığını sürdürür.

Veritabanı silme işlemi için ücret alınmaz.

Konsol

1. Firebase konsolunda Firestore Database sayfasına gidin.

   Firestore veritabanına gitme

2. Veri sekmesinde, veritabanının veri tablosu görünümünün üst kısmında simgesini tıklayın, ardından Veritabanını sil'i seçin.
3. Veritabanını silmek için talimatları uygulayın.

gcloud

`gcloud firestore databases delete` komutunu kullanın.

gcloud firestore databases delete --database=DATABASE_ID

DATABASE_ID kısmını silinecek veritabanının kimliğiyle değiştirin.

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.

Uyarı: Google Cloud Console, veritabanı düzeyinde yapılandırılan IAM koşullarına göre veritabanlarına erişime izin vermez/erişimi reddetmez. Bu yalnızca Google Cloud Console ile veritabanlarına erişim için geçerlidir. IAM koşulları, Google Cloud Console dışındaki veritabanlarına (ör. REST API veya istemci kitaplıkları) erişilirken zorunlu kılınır.

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 Google Hesabı'nı temsil eden e-posta adresi. Örneğin, [e-mail].
• 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, [e-mail].
• 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, [e-mail].

Cloud Monitoring

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

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

firestore.googleapis.com/Database bölümüne bakarak toplu metrikleri veritabanı düzeyinde inceleyebilirsiniz. firestore_instance altında bildirilen 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.
• (default) veritabanınızda GAE arama verileri varsa bu veritabanını silemezsiniz. GAE arama verilerini silmek için lütfen index delete api'yi kullanın. GAE Arama verilerini kısa süre önce sildiyseniz veritabanını silebilmek için beklemeniz gerekebilir.
• (default) veritabanınızda blob öğeleri varsa bu veritabanını silemezsiniz. Blobstore verilerini silmek için lütfen Blobstore delete API'yi kullanın. Google Cloud Console'da SELECT * FROM __BlobInfo__ GQL sorgusunu çalıştırarak (default) veritabanınızda Blobstore verilerinin olup olmadığını kontrol edebilirsiniz.
• Silme işleminden sonraki 5 dakika içinde veritabanı kimliğini yeniden kullanamazsınız.
• Cloud Functions v1, Firestore adlandırılmış veritabanlarını desteklemez. Lütfen adlandırılmış veritabanları için etkinlikleri yapılandırmak üzere Cloud Firestore tetikleyicilerini (2. nesil) kullanın.
• Veritabanı silindikten sonra, aynı adla yeni bir veritabanı oluşturulsa bile Firestore işlevi tetikleyicileri v1 ve Firestore etkinlik tetikleyicileri çalışmayı durdurabilir.

Sırada ne var?

• Veri ekleme
• Veri alma
• Verileri silme