Projeler arasında veri taşıma

Bu sayfada, Cloud Firestore verilerini bir projeden diğerine taşımak için yönetilen içe aktarma ve dışa aktarma özelliklerinin nasıl kullanılacağı açıklanmaktadır. Bu, geliştirme ortamı oluşturmak veya bir uygulamayı kalıcı olarak başka bir projeye taşımak için yararlı olabilir. Bu sayfadaki örnekte, verilerin bir kaynak projeden nasıl dışa aktarılacağı ve ardından bu verilerin bir hedef projeye nasıl içe 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. Dışa aktarma ve içe aktarma işlevini yalnızca faturalandırma özelliği etkinleştirilmiş Google Cloud projeler kullanabilir.

  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. Kompozit dizinler, kaynak ve hedef projeler arasında eşleşmelidir. Her belgenin birden çok kez işlenmesi gerekmemesi için önce dizinler oluşturulmalıdır.

Verileri kaynak projeden 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 FirestoreVeritabanınıza ait 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 paketleri 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üncelleyip tüm Admin SDK işlemlerini durdurarak veritabanınıza yapılan 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 aktarma
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şleminizin 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 bir pakete taşıma

Kaynak paketinizin konumu, 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şlemini 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şleminizin ilerleme durumunu görüntülemek için firestore operations listkomutunu kullanabilirsiniz:

gcloud firestore operations list