Cloud Firestore yönetilen dışa aktarma ve içe aktarma hizmetini kullanarak Yanlışlıkla silinen verileri kurtarmak ve çevrimdışı verileri dışa aktarmak için işleniyor. Tüm dokümanları veya yalnızca belirli koleksiyonları dışa aktarabilirsiniz. Aynı şekilde, Bir dışa aktarma işlemindeki tüm verileri veya yalnızca belirli koleksiyonlardaki verileri içe aktarabilirsiniz. Veri bir Cloud Firestore veritabanından dışa aktarılan başka bir veritabanına aktarılabilir Cloud Firestore veritabanı. Ayrıca BigQuery hedefine Cloud Firestore dışa aktarma işlemi
Bu sayfada, Cloud Firestore dokümanları
yönetilen dışa ve içe aktarma hizmeti ile Cloud Storage. İlgili içeriği oluşturmak için kullanılan
Cloud Firestore yönetilen dışa aktarma ve içe aktarma hizmeti şunun üzerinden kullanılabilir:
gcloud
komut satırı aracı ve Cloud Firestore
API (REST, RPC).
Başlamadan önce
Yönetilen dışa aktarma ve içe aktarma hizmetini kullanabilmek için şu görevlerden yararlanabilirsiniz:
- Etkinleştir Google Cloud projeniz için faturalandırma. Yalnızca Google Cloud faturalandırmanın etkin olduğu projelerde dışa ve içe aktarma işlemleri kullanılabilir.
- Oluştur: projenize yakın bir konumda projeniz için Cloud Storage paketi Cloud Firestore veritabanı konumu. Aksi halde İstek Sahibi, dışa ve içe aktarma işlemleri için paket öder.
-
Hesabınızın aşağıdaki işlemler için gerekli izinlere sahip olduğundan emin olun: Cloud Firestore ve Cloud Storage. Proje sahibiyseniz hesabınızın gerekli izinlere sahip olduğunu doğrulayın. Aksi halde aşağıdaki Roller, dışa ve içe aktarma işlemleri için gerekli izinleri verir. Cloud Storage erişimi için:
- Cloud Firestore rol:
Owner
,Cloud Datastore Owner
veyaCloud Datastore Import Export Admin
Cloud Storage rol:
Owner
veyaStorage Admin
- Cloud Firestore rol:
Hizmet aracısı izinleri
Dışa ve içe aktarma işlemleri bir Cloud Firestore hizmet aracısı kullanarak şu amaçlarla kullanılır: Cloud Storage işlemi yetkilendirin. Cloud Firestore hizmet aracısı şu adlandırma kuralını kullanır:
- Cloud Firestore hizmet aracısı
service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com
Hizmet aracıları hakkında daha fazla bilgi edinmek için Hizmet aracıları.
Cloud Firestore hizmet aracısının Dışa veya içe aktarma işleminde Cloud Storage paket kullanıldı. Cloud Storage paketi, Cloud Firestore paketinizle aynı projede içeriyorsa Cloud Firestore hizmet aracısı paketine otomatik olarak eklenmesini sağlar.
Cloud Storage paketi başka bir projedeyse Cloud Firestore hizmet aracısına Cloud Storage için erişim izni vermelidir paket.
Hizmet aracısına roller atama
gsutil komut satırı aracını kullanarak aşağıdaki rollerden birini atayın. Örneğin, kullanıcıya depolama alanı yöneticisi rolünü atamak için Cloud Firestore hizmet aracısı için aşağıdaki komutu çalıştırın:
gsutil iam ch serviceAccount:service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com:roles/storage.admin \ gs://[BUCKET_NAME]
PROJECT_NUMBER
yerine proje numaranızı yazın. Bu numara
Cloud Firestore hizmet aracınızı adlandırmak için kullanılır.
Hizmet aracısı adını görüntüleme başlıklı makaleyi inceleyin.
Alternatif olarak bu rolü Google Cloud konsolunu kullanarak atayın.
Hizmet aracısı adını göster
İçe ve dışa aktarma işlemlerinizin yetkilendirmek için kullandığı hesabı görüntüleyebilirsiniz istekleri için Google Cloud konsolunun İçe/Dışa Aktar sayfasına gidin. Ayrıca transkriptinizi veritabanınızın Cloud Firestore kullanıp kullanmadığını görüntüleyin hizmet aracısı veya eski App Engine hizmet hesabı.
- Şu sayfanın yanındaki yetkilendirme hesabını görüntüleyin: İçe/Dışa aktarma işleri şu şekilde çalışır: etiketi.
Hizmet aracısının Cloud Storage için Storage Admin
rolüne ihtiyacı var
dışa veya içe aktarma işlemi için kullanılacak pakettir.
Projeniz için gcloud
uygulamasını kurun
Google Cloud Console veya Google Cloud Console üzerinden içe ve dışa aktarma işlemlerini başlatabilirsiniz.
gcloud
komut satırı aracı. gcloud
özelliğini kullanmak için komut satırı aracını kurun
aşağıdaki yöntemlerden birini kullanarak projenize bağlanabilirsiniz:
Cloud Shell kullanarak Google Cloud Platform konsolundan
gcloud
hizmetine erişin.gcloud
öğesinin doğru proje için yapılandırıldığından emin olun:gcloud config set project [PROJECT_ID]
Verileri dışa aktarın
Dışa aktarma işlemi, veritabanınızdaki dokümanları bir dosya kümesine kopyalar ve Cloud Storage paket. Dışa aktarma işleminin, alınan veritabanı anlık görüntüsüyle aynı olmadığını unutmayın. dışa aktarma başlangıç zamanında. Dışa aktarma işlemi, işlem sırasında yapılan değişiklikleri içerebilir. çalışıyordu.
Tüm dokümanları dışa aktar
Google Cloud Console
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
Dışa aktar'ı tıklayın.
Export all database'i (Veritabanının tamamını dışa aktar) tıklayın.
Hedef Seçin'in altına Cloud Storage paketinin adını girin veya bir paket seçmek için Göz at düğmesini kullanın.
Dışa aktar'ı tıklayın.
Konsol İçe/Dışa Aktar sayfasına döner. İşlem başarıyla başlarsa Sayfa, son içe ve dışa aktarma işlemleri sayfasına bir giriş ekler. Hata durumunda, sayfada bir hata mesajı görüntülenir.
gcloud
Tümünü dışa aktarmak için firestore export
komutunu kullanın
veritabanınızdaki dokümanlarda [BUCKET_NAME]
yerine kullandığınız e-posta adresini
Cloud Storage paket. gcloud
aracının şunları yapmasını önlemek için --async
işaretini ekleyin:
işlemin tamamlanmasını bekliyor.
gcloud firestore export gs://[BUCKET_NAME] \ --database=[DATABASE]
Aşağıdakini değiştirin:
BUCKET_NAME
: sonrasında bir dosya öneki ekleyerek dışa aktarmalarınızı düzenleyin paket adı (örneğin,BUCKET_NAME/my-exports-folder/export-name
). Eğer dosya öneki sağlamazsanız yönetilen dışa aktarma hizmeti geçerli zaman damgasına göre bir tane oluşturur.DATABASE
: Dışa aktarmak istediğiniz veritabanının adı belgeler. Varsayılan veritabanı için--database='(default)'
kullanın.
Bir dışa aktarma işlemi başlattığınızda, terminalin kapatılması işlemi iptal etme bölümünü inceleyin.
Belirli koleksiyonları dışa aktarma
Google Cloud Console
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
Dışa aktar'ı tıklayın.
Bir veya daha fazla koleksiyon grubunu dışa aktar seçeneğini tıklayın. Açılır listeyi kullanın menüsünde bir veya daha fazla koleksiyon grubu seçin.
Hedef Seçin'in altına Cloud Storage paketinin adını girin veya bir paket seçmek için Göz at düğmesini kullanın.
Dışa aktar'ı tıklayın.
Konsol İçe/Dışa Aktar sayfasına döner. İşlem başarıyla başlarsa Sayfa, son içe ve dışa aktarma işlemleri sayfasına bir giriş ekler. Hata durumunda, sayfada bir hata mesajı görüntülenir.
gcloud
Belirli koleksiyon gruplarını dışa aktarmak için
--collection-ids
işareti. İşlemde yalnızca dışa aktarım
belirtilen koleksiyon kimliklerine sahip koleksiyon gruplarını. Koleksiyon grubu
içeren tüm koleksiyonları ve alt koleksiyonları içerir (herhangi bir yoldaki)
koleksiyon kimliği.
gcloud firestore export gs://[BUCKET_NAME] \ --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \ --database=[DATABASE]
Örneğin, foo
veritabanında restaurants
koleksiyonunu
ratings
, reviews
veya outlets
gibi birden çok alt koleksiyon. Belirli bir restaurants
ve reviews
koleksiyonunu dışa aktarmak için komutunuz şu şekilde görünür:
şöyle olur:
gcloud firestore export gs://[BUCKET_NAME] \ --collection-ids=restaurants,reviews \ --database='cymbal'
PITR zaman damgasından dışa aktarma
Veritabanınızı PITR verilerinden Cloud Storage hizmetine aktarabilirsiniz
gcloud firestore export
komutunu kullanabilirsiniz. Zaman damgasının bir tam dakika zaman damgası olduğu durumlarda, PITR verilerini dışa aktarabilirsiniz.
yalnızca son yedi gün içindeki earliestVersionTime
aralığından önce değil. Veriler artık güncel değilse
belirtilen zaman damgasında görünüyorsa dışa aktarma işlemi başarısız olur.
PITR dışa aktarma işlemi, tüm dokümanları dışa aktarma ve belirli koleksiyonları dışa aktarma da dahil olmak üzere tüm filtreleri destekler.
snapshot-time
parametresini istenen kurtarma zaman damgasına göre belirterek veritabanını dışa aktarın.gcloud
Veritabanını paketinize aktarmak için aşağıdaki komutu çalıştırın.
gcloud firestore export gs://[BUCKET_NAME_PATH] \ --snapshot-time=[PITR_TIMESTAMP] \ --collection-ids=[COLLECTION_IDS] \ --namespace-ids=[NAMESPACE_IDS]
Nerede,
PITR_TIMESTAMP
- dakika ayrıntı düzeyinde bir PITR zaman damgası (örneğin,2023-05-26T10:20:00.00Z
).
PITR verilerini dışa aktarmadan önce aşağıdaki noktaları göz önünde bulundurun:
- RFC 3339'da zaman damgasını belirtin
biçimindedir.
Örneğin,
2020-09-01T23:59:30.234233Z
. - Belirttiğiniz zaman damgasının tam dakika zaman damgası olduğundan emin olun.
son yedi gün içinde, yalnızca
earliestVersionTime
Veriler belirtilen konumda artık yoksa zaman damgası kullanılırsa bir hata oluşur. - Başarısız PITR dışa aktarma işlemi için sizden ücret alınmaz.
Verileri içe aktarma
Dosyalarınızı Cloud Storage üzerinde dışa aktardıktan sonra bu klasörlere aktarabilirsiniz veya başka bir projeye gönderebilirsiniz. Aşağıdaki noktalara dikkat edin içe aktarma işlemleri hakkında:
Verileri içe aktardığınızda gerekli dizinler, veritabanınızın mevcut dizin tanımlarını gösterir. Dışa aktarma işlemi dizin tanımları içermez.
İçe aktarma işlemlerinde yeni doküman kimlikleri atanmaz. İçe aktarma işlemlerinde, şurada yakalanan kimlikler kullanılır: dışa aktarım zamanı. Bir doküman içe aktarılırken kimliği ayrılmış (kimlik çakışmalarını önlemek için) Aynı kimliğe sahip bir doküman zaten varsa mevcut dokümanın üzerine yazar.
Veritabanınızdaki bir doküman içe aktarma işleminden etkilenmiyorsa içe aktarma işleminden içe aktarma işleminden sonra veritabanınıza geri yüklenir.
İçe aktarma işlemleri Cloud Functions'ı tetiklemez. Anlık görüntü işleyicileri içe aktarma işlemleriyle ilgili güncellemeleri almaz.
.overall_export_metadata
dosya adı, üst dosyasının adıyla eşleşmelidir. klasör:gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/PARENT_FOLDER_NAME/PARENT_FOLDER_NAME.overall_export_metadata
Bir dışa aktarma işleminin çıkış dosyalarını taşır veya kopyalarsanız PARENT_FOLDER_NAME ve
.overall_export_metadata
, aynı.
Dışa aktarmadaki tüm dokümanları içe aktarma
Google Cloud Console
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
İçe aktar'ı tıklayın.
Dosya adı alanına bir dosyanın adını girin Tamamlanan dışa aktarma işleminden
.overall_export_metadata
dosya. Şunları yapabilirsiniz: dosyayı seçmenize yardımcı olması için Göz at düğmesini kullanın.İçe aktar'ı tıklayın.
Konsol İçe/Dışa Aktar sayfasına döner. İşlem başarıyla başlarsa Sayfa, son içe ve dışa aktarma işlemleri sayfasına bir giriş ekler. Hata durumunda, sayfada bir hata mesajı görüntülenir.
gcloud
Birfirestore import
önceki dışa aktarma işlemidir.
gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]
Aşağıdakini değiştirin:
BUCKET_NAME/EXPORT_PREFIX
: bulunduğunuz konum dışa aktarabilirsiniz.DATABASE
: Veritabanının adı. Varsayılan veritabanı için--database='(default)'
kullanın.
Örneğin:
gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'
Dışa aktarma dosyalarınızın konumunu Google Cloud Console'da Cloud Storage tarayıcı:
Bir içe aktarma işlemi başlattığınızda, terminalin kapatılması işlemi iptal etme bölümünü inceleyin.
Belirli koleksiyonları içe aktarma
Google Cloud Console
Konsolda belirli koleksiyonları seçemezsiniz. Bunun yerine gcloud
politikasını kullanın.
gcloud
Dışa aktarma dosyaları kümesinden belirli koleksiyon gruplarını içe aktarmak için
--collection-ids
işareti. İşlem
yalnızca belirtilen koleksiyon kimliklerine sahip koleksiyon gruplarını kullanın. Koleksiyon
grubu,
belirtilen koleksiyon kimliği. --database
kullanarak veritabanı adını belirtin
tıklayın. Varsayılan veritabanı için --database='(default)'
kullanın.
Yalnızca belirli koleksiyon gruplarının dışa aktarılması belirli koleksiyon gruplarının içe aktarılmasını destekler koleksiyon grupları. Tüm koleksiyonları dışa aktarma işleminden belirli koleksiyonları içe aktaramazsınız. yardımcı olur.
gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ \ --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \ --database=[DATABASE]
PITR dışa aktarma işlemini içe aktarma
Dışa aktarılan dosyalarınızı içe aktarmak için Tüm dokümanları içe aktarma başlıklı makaledeki adımları uygulayın. Veritabanınızda mevcut olan bir belge, üzerine yazılır.
Dışa ve içe aktarma işlemlerini yönetme
Bir dışa veya içe aktarma işlemi başlattığınızda, Cloud Firestore şunları atar: işleme benzersiz bir ad verin. Silmek için işlem adını kullanabilirsiniz, işlemi iptal edebilir veya işlemin durumunu kontrol edebilirsiniz.
İşlem adlarının başında projects/[PROJECT_ID]/databases/(default)/operations/
öneki bulunur,
örneğin:
projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg
Ancak aşağıdakiler için bir işlem adı belirtirken öneki çıkarabilirsiniz
describe
, cancel
ve delete
komutlar.
Tüm dışa ve içe aktarma işlemlerini listeleme
Google Cloud Console
Son dışa ve içe aktarma işlemlerinin listesini Google Cloud Console'un İçe/Dışa Aktar sayfasını açın.
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
gcloud
operations list
komutunu kullanarak tüm çalışan ve
yakın zamanda tamamlanan dışa ve içe aktarma işlemleri:
gcloud firestore operations list
İşlem durumunu kontrol et
Google Cloud Console
Son yaptığınız dışa veya içe aktarma işleminin durumunu Google Cloud Console'un İçe/Dışa Aktar sayfasını açın.
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
gcloud
Dışa aktarma işleminin durumunu göstermek için operations describe
komutunu kullanma
içe aktarma işlemi olabilir.
gcloud firestore operations describe [OPERATION_NAME]
Tamamlanma süresini tahmin etme
Uzun süreli bir işlemin durumuyla ilgili istek, metrikleri döndürür
workEstimated
ve workCompleted
. Bu metriklerin her biri hem
bayt sayısı ve varlık sayısı:
workEstimated
, tahmini toplam bayt ve doküman sayısını gösterir. işlenecek. Cloud Firestore bu metriği atlayabilir. tahmin edemezler.workCompleted
, o ana kadar işlenen bayt ve doküman sayısını gösterir. İşlem tamamlandıktan sonra, değer burada gösterilen tam olarak işlenen bayt ve dokümanların yanı sıraworkEstimated
değerine ayarlanır.
İlerleme tahmini için workCompleted
değerini workEstimated
değerine bölün. Bu
tahmini gecikmeli istatistiklere bağlı olduğundan yanlış olabilir
koleksiyonudur.
İşlemi iptal etme
Google Cloud Console
Devam eden bir dışa aktarma veya içe aktarma işlemini Google Cloud Console'un İçe/Dışa Aktar sayfasını açın.
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanı listesinden gerekli veritabanını seçin.
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
Şu anda çalışan Son içe aktarma ve dışa aktarma işlemleri tablosunda işlemlerin Tamamlandı sütununda bir İptal düğmesi bulunur. Önce İşlemi durdurmak için İptal düğmesi. Düğme, İptal ediliyor olarak değişir. mesajını ve ardından işlem tamamen durduğunda Cancelled (İptal edildi) mesajını görürsünüz.
gcloud
Devam eden bir işlemi durdurmak için operations cancel
komutunu kullanın:
gcloud firestore operations cancel [OPERATION_NAME]
Çalışmakta olan bir işlemin iptal edilmesi, işlemin geri alınmasına neden olmaz. İptal edilmiş dışa aktarma işlemi, zaten Cloud Storage konumunda dışa aktarılmış dokümanları bırakacak ve bir iptal işlemi, içe aktarma işlemi, veritabanınızda önceden yapılmış güncellemeleri yerinde bırakır. Siz kısmen tamamlanmış bir dışa aktarma içe aktarılamıyor.
İşlemi silme
Kaldırmak için gcloud firestore operations delete
komutunu kullanın
son işlemler listesinden bir işlem. Bu komut, verileri
Cloud Storage içinden dosyaları dışa aktarabilirsiniz.
gcloud firestore operations delete [OPERATION_NAME]
İhracat ve ithalat işlemleri için faturalandırma ve fiyatlandırma
Kullanmadan önce Google Cloud projeniz için faturalandırmayı etkinleştirmeniz gerekir yönetilen dışa aktarma ve içe aktarma hizmeti sunar.
İhracat ve içe aktarma işlemleri ücretlendirilir için aşağıdaki fiyatlarda belirtilen fiyatlar üzerinden belge okuma ve yazma işlemleri için: Cloud Firestore fiyatlandırması. Dışa aktarma işlemleri bir okuma gerçekleştirir işlem sayısı. İçe aktarma işlemleri başına bir yazma işlemi uygulanır doküman içe aktarıldı.
Cloud Storage içinde depolanan çıkış dosyaları şuna dahil edilir: Cloud Storage veri depolama maliyetleri.
İhracat ve içe aktarma işlemlerinin maliyetleri harcamanıza dahil edilmez. sınır. Dışa aktarma veya içe aktarma işlemleri İşlem tamamlanana kadar Google Cloud bütçe uyarısı gönderin. Aynı şekilde, dışa veya içe aktarma işlemi sırasında gerçekleştirilen okuma ve yazma işlemleri, İşlem tamamlandıktan sonra günlük kotanıza. Dışa aktarma ve içe aktarma işlemleri, konsolun kullanım bölümünde gösterilen kullanımı etkilemez.
İhracat ve ithalat maliyetlerini görüntüleme
Dışa aktarma ve içe aktarma işlemleri goog-firestoremanaged:exportimport
öğesini uygular
faturalandırılan işlemlere etiketi ekleyin. Cloud Faturalandırma raporları sayfasında
Bu etiketi, içe ve dışa aktarma işlemleriyle ilgili maliyetleri görüntülemek için kullanabilirsiniz:
BigQuery'ye aktarın
Cloud Firestore dışa aktarma işleminden BigQuery ürününe veri yükleyebilirsiniz.
ancak yalnızca bir collection-ids
filtresi belirttiyseniz. Görüntüleyin
Cloud Firestore dışa aktarma işleminden veri yükleniyor.
BigQuery sütun sınırı
BigQuery,tablo başına 10.000 sütun sınırı uygular. Cloud Firestore dışa aktarma işlemi bir BigQuery tablosu oluşturur bir şema oluşturabilirsiniz. Bu şemada, bir koleksiyon grubu şema sütunu haline gelir.
Bir koleksiyon grubunun BigQuery şeması 10.000 sütunu aşıyorsa Cloud Firestore dışa aktarma işlemi, sütun sınırının altında kalmaya çalışıyor bayt olarak işleyerek. Bu dönüşüm sütun sayısını seçerseniz verileri aşağıdaki sütunlara yükleyebilirsiniz: BigQuery, ancak eşleme alanlarındaki alt alanları sorgulayamazsınız. Sütun sayısı hâlâ 10.000'i aşıyorsa dışa aktarma işlemi koleksiyon grubu için bir BigQuery şeması oluşturur ve siz yükleyemezsiniz BigQuery ürününe gönderir.
Biçim ve meta veri dosyalarını dışa aktarma
Yönetilen dışa aktarma işleminin sonucunda LevelDB günlük biçimi.
Meta veri dosyaları
Dışa aktarma işlemi, her koleksiyon grubu için bir meta veri dosyası oluşturur
belirtir. Meta veri dosyaları genellikle
ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata
Meta veri dosyaları protokol arabellekleridir ve bu dosyaların kodunu
protoc
protokol derleyici.
Örneğin, koleksiyon gruplarını belirlemek için bir meta veri dosyasının kodunu çözebilirsiniz.
Dışa aktarma dosyaları şunları içerir:
protoc --decode_raw < export0.export_metadata
Hizmet aracısı taşıma
Cloud Firestore, içe aktarmayı yetkilendirmek için bir Cloud Firestore hizmet aracısı kullanır ve dışa aktarma işlemlerini App Engine hizmet hesabını kullanmak yerine. Hizmet aracısı ve hizmet hesabı aşağıdaki adlandırma kurallarını kullanır:
- Cloud Firestore hizmet aracısı
service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com
Cloud Firestore daha önce App Engine varsayılan hizmetini kullandı yerine Cloud Firestore hizmet aracısı yerine hesabınızı kullandığınızdan emin olun. Veritabanınız App Engine hizmet hesabını kullanarak verileri içe veya dışa aktarmaya devam ediyorsa verilerini taşımak için bu bölümdeki talimatları uygulamanızı Cloud Firestore hizmet aracısını kullanmaya başlar.
- App Engine hizmet hesabı
PROJECT_ID@appspot.gserviceaccount.com
Spesifik olduğu için Cloud Firestore hizmet aracısı tercih edilir Cloud Firestore numaralı telefona. App Engine hizmet hesabı paylaşılıyor birden fazla hizmet tarafından işlemesini sağlar.
Yetkilendirme hesabını görüntüle
İçe ve dışa aktarma işlemlerinizin yetkilendirme için hangi hesabı kullandığını görüntüleyebilirsiniz istekleri için Google Cloud konsolunun İçe/Dışa Aktar sayfasına gidin. Ayrıca transkriptinizi veritabanınız zaten Cloud Firestore kullanıyorsa hizmet temsilcisiyle iletişim kurabilirsiniz.
-
Google Cloud Console'da Veritabanları sayfasına gidin.
- Veritabanı listesinden gerekli veritabanını seçin.
-
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
- Şu sayfanın yanındaki yetkilendirme hesabını görüntüleyin: İçe/Dışa aktarma işleri şu şekilde çalışır: etiketi.
Projeniz Cloud Firestore hizmet aracısını kullanmıyorsa aşağıdakilerden birini kullanarak Cloud Firestore hizmet aracısına taşıyabilirsiniz şu teknikleri uygulayın:
- Cloud Storage paket izinlerini kontrol edip güncelleyerek bir projeyi taşıyın (önerilir).
- Dahil olan tüm projeleri etkileyen kuruluş genelinde bir politika kısıtlaması ekleyin kurum içinde tutmaktır.
Bu tekniklerden ilki tercih edilir çünkü tek bir Cloud Firestore projesine etkisi olur. İkinci teknik ise mevcut Cloud Storage paketini taşımadığı için tercih edilir izin verir. Bununla birlikte, kuruluşta güvenlik uygunluğu sunar. seviyesidir.
Cloud Storage paket izinlerini kontrol edip güncelleyerek taşıyın
Taşıma işlemi iki adımdan oluşur:
- Cloud Storage paket izinlerini güncelleyin. Aşağıdaki bölümde bolca fırsat sunuyor.
- Cloud Firestore hizmet aracısına taşıma işlemini onaylayın.
Hizmet aracısı paket izinleri
Cloud Storage paketi kullanan tüm dışa aktarma veya içe aktarma işlemleri için başka bir proje için Cloud Firestore hizmet aracısına izin vermelisiniz tüm izinleri verebilirsiniz. Örneğin, verileri başka bir cihaza taşıyan işlemler projenin diğer projedeki bir pakete erişmesi gerekir. Aksi halde Cloud Firestore hizmetine taşıma sonrasında işlemler başarısız oldu yardımcı olur.
Aynı proje içinde kalan içe ve dışa aktarma iş akışları gerekli değildir izinlerde yapılan değişiklikler hakkında daha fazla bilgi edinin. Cloud Firestore hizmet aracısı erişebilir aynı projedeki pakettir.
Diğer projelerdeki Cloud Storage paket izinlerini güncellemek için
şuna erişin:
service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com
hizmet temsilcisiyle iletişim kurabilirsiniz. Hizmet aracısına Firestore Service Agent
rolü verin.
Firestore Service Agent
rolü,
Cloud Storage paket. Salt okunur veya salt okuma izni vermeniz gerekiyorsa
bir
özel rol hakkında daha fazla bilgi edinin.
Aşağıdaki bölümde açıklanan taşıma süreci Cloud Storage adlı yeri tanımlamanıza yardımcı olur izin güncellemeleri gerekebilir.
Projeleri Firestore Hizmet Aracısı'na taşıma
App Engine hizmet hesabından veri taşıma işlemini yapmak için aşağıdaki adımları tamamlayın Cloud Firestore hizmet aracısı. Taşıma işlemi tamamlandıktan sonra geri alındı.
-
Google Cloud Console'da Veritabanları sayfasına gidin.
- Veritabanı listesinden gerekli veritabanını seçin.
-
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
-
Projeniz henüz Cloud Firestore hizmetine taşınmadıysa taşıma işlemini açıklayan bir banner görürsünüz ve Paket Durumunu Kontrol Et düğmesi. Bir sonraki adım, proje yöneticisi olarak Olası izin hatalarını düzeltebilirsiniz.
Paket Durumunu Kontrol Et'i tıklayın.
Taşıma işleminizi tamamlama seçeneğini ve bir Cloud Storage paket listesi. Bu işlem birkaç dakika sürebilir. listenin yüklenmesini tıklayın.
Bu listede, yakın zamanda içe ve dışa aktarma işlemlerinde kullanılır ancak şu anda okuma ve dışa aktarma işlemleri için Cloud Firestore hizmet aracısına yazma izinleri verir.
- Projenizin Cloud Firestore ana adını not edin hizmet temsilcisiyle iletişim kurabilirsiniz. Hizmet aracısı adı Erişim izni verilecek hizmet aracısı etiketi.
-
Listedeki herhangi bir paket için gelecekteki içe veya dışa aktarma işlemlerinde kullanılabilmesi için aşağıdaki için şu adımları izleyin:
-
Bu paketin tablo satırında Düzelt'i tıklayın. Bu işlem, paketin izinler sayfasını yeni bir sekmede açar.
- Ekle'yi tıklayın.
- Yeni ana hesaplar alanına Cloud Firestore hizmet aracısı.
- Rol seçin alanında Hizmet Aracıları > Firestore Hizmet Aracısı.
- Kaydet'i tıklayın.
- Cloud Firestore İçe/Dışa Aktar sayfasının bulunduğu sekmeye dönün.
- Listedeki diğer paketler için bu adımları tekrarlayın. Görüntüledikten sonra, listenin tüm sayfalarında yer alır.
-
-
Firestore Hizmet Aracısı'na taşı'yı tıklayın. Şu durumda: hâlâ başarısız izin kontrolü olan paketleriniz varsa Taşı'yı tıklayarak taşıma işleminizi onaylamanız gerekir.
Taşıma işleminiz tamamlandığında bir uyarı alırsınız. Taşıma işlemi geri alındı.
Taşıma durumunu görüntüleme
Projenizin taşıma durumunu doğrulamak için:
-
Google Cloud Console'da Veritabanları sayfasına gidin.
- Veritabanı listesinden gerekli veritabanını seçin.
-
Gezinme menüsünde İçe/Dışa Aktar'ı tıklayın.
-
İşleri şu şekilde çalışır: İçe/Dışa aktar etiketinin yanındaki ana hesabı bulun.
Ana hesap
service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com
ise projeniz zaten Cloud Firestore hizmet temsilcisiyle iletişim kurabilirsiniz. Taşıma işlemi geri alınamaz.Proje taşınmadıysa sayfanın üst kısmında bir banner gösterilir Paket Durumunu Kontrol Et düğmesiyle. Görüntüleyin Firestore hizmet aracısına geçiş yapma tıklayın.
Kuruluş genelinde bir politika kısıtlaması ekleyin
-
Kuruluşunuzun politikasında aşağıdaki kısıtlamayı ayarlayın:
İçe/dışa aktarma için Firestore Hizmet Aracısı'nı zorunlu kıl (
firestore.requireP4SAforImportExport
).Bu kısıtlama, İstekleri yetkilendirmek için Cloud Firestore hizmet aracısı. Bu kısıtlamayı ayarlamak için bkz. Kuruluş politikaları oluşturma ve yönetme ziyaret edin.
Bu kuruluş politikası kısıtlaması uygulandığında için uygun Cloud Storage paket izinleri Cloud Firestore hizmet aracısı.
Kısıtlama, herhangi bir içe veya dışa aktarma iş akışı için izin hataları oluşturuyorsa devre dışı bırakarak varsayılan hizmet hesabını kullanmaya geri dönebilirsiniz. Cloud Storage paketi kontrol edip güncelledikten sonra izin seçeneğini belirlerseniz kısıtlamayı tekrar etkinleştirebilirsiniz.