Projeler arasında veri taşıma

Bu sayfada, Cloud Firestore verilerini bir projeden diğerine taşımak için yönetilen içe ve dışa aktarma özelliklerinin nasıl kullanılacağı açıklanmaktadır. Bu, geliştirme ortamı oluştururken veya bir uygulamayı başka bir projeye kalıcı olarak taşıma sürecinin bir parçası olarak faydalı olabilir. Bu sayfadaki örnekte, verilerin bir kaynak projeden dışa aktarılıp ardından hedef projeye nasıl aktarılacağı gösterilmektedir. Verileri projeler arasında taşıma işlemi aşağıdaki adımları içerir:

  1. Kaynak projenizdeki verileri saklayacak bir Cloud Storage paketi oluşturun.
  2. Kaynak projenizdeki verileri pakete aktarın.
  3. Hedef projenize paketten okuma izni verin.
  4. Paketteki verileri hedef projenize aktarın.

Başlamadan önce

Yönetilen dışa aktarma ve içe aktarma hizmetini kullanabilmek için aşağıdaki görevleri tamamlamanız gerekir:

  1. Hem kaynak projeniz hem de hedef projeniz için faturalandırmayı etkinleştirin. Yalnızca faturalandırma özelliği etkinleştirilmiş Google Cloud projelerde dışa aktarma ve içe aktarma işlevi kullanılabilir.

  2. Hesabınızın kaynak projenizde ve hedef projenizde gerekli Cloud IAM izinlerine sahip olduğundan emin olun. Her iki projenin de sahibiyseniz hesabınızda gerekli izinler vardır. Aksi takdirde, aşağıdaki Cloud IAM rolleri Cloud Firestore dışa aktarma ve içe aktarma işlemleri için gerekli izinleri verir:

    Owner, Cloud Datastore Owner veya Cloud Datastore Import Export Admin

    Proje sahipleri, Erişim verme bölümündeki adımları uygulayarak bu rollerden birini verebilir.

  3. gcloud komut satırı aracını kurun ve aşağıdaki yöntemlerden birini kullanarak projenize bağlanın:

  4. Yeni projenizde dizinler oluşturun. Bileşik dizinler, kaynak ve hedef projeler arasında eşleşmelidir. Her belgenin birden fazla kez işlenmesi gerekmemesi için önce dizinler oluşturulmalıdır.

Kaynak projeden veri dışa aktarma

Cloud Firestore dışa aktarma dosyalarınız için bir Cloud Storage paketi oluşturup dışa aktarma işlemi başlatarak verilerinizi dışa aktarın.

Cloud Storage paketi oluşturma

Cloud Firestore veritabanınızla aynı konumda Cloud Storage paketi oluşturun. Veritabanı konumunuzu görüntülemek için proje konum ayarlarınıza bakın. Dışa aktarma ve içe aktarma işlemleri için istek sahibinin ödediği bir paket kullanamazsınız.

Cloud Storage paketiniz kaynak projenizde yoksa kaynak projenin varsayılan hizmet hesabına pakete erişim izni vermeniz gerekir. Her Google Cloud projesinde, PROJECT_ID@appspot.gserviceaccount.com adlı otomatik olarak oluşturulmuş bir varsayılan hizmet hesabı bulunur. Cloud Firestore dışa aktarma işlemleri, Cloud Storage paket işlemleri için yetkilendirme yapmak amacıyla bu varsayılan hizmet hesabını kullanır. Varsayılan hizmet hesabına kaynak paketinize erişim izni vermek için Storage Admin rolünü verin.

Bu rolü, Cloud Shell'da bulunan gsutil aracıyla verebilirsiniz:

Cloud Shell'i başlatın 

gsutil iam ch serviceAccount:[service-PROJECT_NUMBER]@gcp-sa-firestore.iam.gserviceaccount.com :roles/storage.admin\
gs://[BUCKET_NAME]@

Bu rolü Google Cloud konsolunda da verebilirsiniz.

Yazma işlemlerini devre dışı bırakma (isteğe bağlı)

Dışa aktarma işlemi gerçekleştirirken uygulamanız veritabanınıza yazmaya devam ederse bu yazma işlemlerinin tümünü dışa aktarma dosyalarınıza kaydedemeyebilirsiniz. Verileri tutarlı bir durumdan dışa aktarmak için güvenlik kurallarınızı güncelleyerek ve tüm Yönetici SDK'sı işlemlerini durdurarak veritabanınıza yazma işlemlerini devre dışı bırakın.

  1. Güvenlik kurallarını güncelleme

    Console'un Cloud Firestore Kurallar sekmesinde kaynak proje güvenlik kurallarınızı tüm yazma işlemlerini reddetecek şekilde güncelleyin. Örneğin:

      // Deny write access to all users under any conditions
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow write: if false;
      }
      // Reads do not affect export operations
      // Add your read rules here
    }
  }

  2. Admin SDK'larından gelen yazma işlemlerini durdurma

    Güvenlik kuralları, Firebase Admin SDK veya Google Cloud Server Client Library kullanılarak oluşturulan ayrıcalıklı sunucu ortamlarından gelen yazma işlemlerini durdurmaz. Sunucularınızı kapatarak veya güncelleyerek yönetici sunucularınızdan yazma işlemlerini durdurduğunuzdan emin olun.

Dışa aktarma işlemi başlatma

Kaynak projenizden veri dışa aktarmak için gcloud firestore export komutunu kullanın. Tüm verilerinizi veya yalnızca belirli koleksiyonları dışa aktarabilirsiniz. [SOURCE_BUCKET] yerine Cloud Storage paketinizin adını yazın:

Tüm verileri dışa aktar
gcloud firestore export gs://[SOURCE_BUCKET] --async
Belirli koleksiyonları dışa aktarma
gcloud firestore export gs://[SOURCE_BUCKET] --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2] --async

Daha sonra kullanacağınız için dışa aktarma işleminizin outputURIPrefix değerini not edin. Varsayılan olarak Cloud Firestore, dışa aktarma dosyalarınıza zaman damgasına göre bir ön ek ekler:

outputUriPrefix: gs://[SOURCE_BUCKET]/2019-03-05T20:58:23_56418

Dışa aktarma işlemi çalışırken işlemin ilerleme durumunu görüntülemek için firestore operations listkomutunu kullanabilirsiniz:

gcloud firestore operations list

Verileri hedef projeye aktarma

Ardından, hedef projeye Cloud Firestore veri dosyalarınıza erişim izni verin ve bir içe aktarma işlemi başlatın.

Hedef projeye veri dosyalarınıza erişim izni verme

İçe aktarma işlemine başlamadan önce, hedef projenizin Cloud Firestoreveri dosyalarınıza erişebildiğinden emin olmanız gerekir.

Veri dosyalarını yerel pakete taşıma

Kaynak paket konumunuz, hedef projenizin Cloud Firestore konumundan farklıysa veri dosyalarınızı hedef projenizle aynı konumdaki bir Cloud Storage paketine taşımanız gerekir.

Paketleri Taşıma ve Yeniden Adlandırma bölümündeki adımları uygulayarak veri dosyalarınızı başka bir Cloud Storage paketine taşıyın. Aşağıdaki tüm adımlarda [SOURCE_BUCKET] olarak bu yeni paketi kullanın.

Proje hizmet hesabına kaynak paketinize erişim izni verin

Kaynak paketiniz hedef projenizde değilse hedef projenin varsayılan hizmet hesabına kaynak paketinize erişim izni vermeniz gerekir. Varsayılan hizmet hesabı [DESTINATION_PROJECT_ID]@appspot.gserviceaccount.com olarak adlandırılır. Varsayılan hizmet hesabına kaynak paketinize erişim izni vermek için pakete erişmek üzere gerekli izinleri verin.

Cloud Shell'da bulunan gsutil aracını kullanarak gerekli rolleri verebilirsiniz:

Cloud Shell'i başlatın 

gsutil iam ch serviceAccount:[DESTINATION_PROJECT_ID]@appspot.gserviceaccount.com:legacyBucketReader,legacyObjectReader \
gs://[SOURCE_BUCKET]

Bu rolü Google Cloud konsolunda da verebilirsiniz.

İçe aktarma işlemi başlatma

İçe aktarma işlemini başlatmadan önce gcloud'ün doğru proje için yapılandırıldığından emin olun:

gcloud config set project [DESTINATION_PROJECT_ID]

Kaynak paketinizdeki verileri hedef projenize aktarmak için gcloud firestore import komutunu kullanın:

gcloud firestore import gs://[SOURCE_BUCKET]/[EXPORT_PREFIX] --async

Burada [EXPORT_PREFIX], dışa aktarma işleminizin outputUriPrefix ön ekiyle eşleşir. Örneğin:

gcloud firestore import gs://[SOURCE_BUCKET]/2019-03-05T20:58:23_56418 --async

Dışa aktarma işlemi çalışırken işlemin ilerleme durumunu görüntülemek için firestore operations listkomutunu kullanabilirsiniz:

gcloud firestore operations list