Bu sayfada, Cloud Firestore verilerinizin dışa aktarma işlemlerini nasıl planlayacağınız açıklanmaktadır. Dışa aktarma işlemlerini planlı olarak çalıştırmak için Cloud Functions ve Cloud Scheduler kullanmanızı öneririz.
Başlamadan önce
Yönetilen veri dışa aktarma işlemlerini planlamadan önce aşağıdaki görevleri tamamlamanız gerekir:
- Google Cloud projeniz için faturalandırmayı etkinleştirin. Dışa ve içe aktarma özelliğini yalnızca faturalandırma etkinleştirilmiş Google Cloud projeler kullanabilir.
- Dışa aktarma işlemleri için hedef Cloud Storage paketi gerekir. Cloud Firestore veritabanı konumunuza yakın bir konumda Cloud Storage paketi oluşturun. Dışa aktarma işlemleri için istekte bulunanın ödediği bir paket kullanamazsınız.
Cloud Functions işlevi ve Cloud Scheduler işi oluşturma
Cloud Firestore veri dışa aktarma ve bu işlevi çağırmak için Cloud Scheduler işi başlatan bir Node.js Cloud Function oluşturmak üzere aşağıdaki adımları uygulayın:
Firebase CLI
-
Firebase CLI'yı yükleyin. Yeni bir dizinde, Cloud Functions için CLI'yı başlatın:
firebase init functions --project PROJECT_ID
- Dil olarak JavaScript'i seçin.
- İsteğe bağlı olarak ESLint'i etkinleştirin.
- Bağımlılıkları yüklemek için
ygirin.
-
functions/index.jsdosyasındaki kodu aşağıdakiyle değiştirin:const functions = require('firebase-functions'); const firestore = require('@google-cloud/firestore'); const client = new firestore.v1.FirestoreAdminClient(); // Replace BUCKET_NAME const bucket = 'gs://BUCKET_NAME'; exports.scheduledFirestoreExport = functions.pubsub .schedule('every 24 hours') .onRun((context) => { const projectId = process.env.GCP_PROJECT; const databaseName = client.databasePath(projectId, '(default)'); return client.exportDocuments({ name: databaseName, outputUriPrefix: bucket, // Leave collectionIds empty to export all collections // or set to a list of collection IDs to export, // collectionIds: ['users', 'posts'] collectionIds: [] }) .then(responses => { const response = responses[0]; console.log(`Operation Name: ${response['name']}`); }) .catch(err => { console.error(err); throw new Error('Export operation failed'); }); });
-
Önceki kodda aşağıdakileri değiştirin:
BUCKET_NAMEyerine paketinizi adını yazın.YOUR_PROJECT_IDyerine proje kimliğinizi yazın.- Dışa aktarma planınızı ayarlamak için
every 24 hoursöğesini değiştirin. Şunlardan birini kullanın: App Engine cron.yaml söz dizimi veya unix-cron biçimi (* * * * *). -
Yalnızca belirtilen koleksiyon gruplarını dışa aktarmak için
collectionIds: []değerini değiştirin. Tüm koleksiyon gruplarını dışa aktarmak için olduğu gibi bırakın.
-
Planlanan işlevi dağıtın:
firebase deploy --only functions
Google Cloud konsolu
Cloud Functions işlevi oluştur
-
Google Cloud Console'da Cloud Functions sayfasına gidin:
- İşlev yaz'ı tıklayın.
firestore-exportgibi bir işlev adı girin.- Tetikleyici bölümünde Cloud Pub/Sub'ı seçin.
- Konu bölümünde Yeni Konu Oluştur'u seçin. Pub/Sub konusu için bir ad girin (ör.
initiateFirestoreExport). Cloud Scheduler işinizi oluşturmak için ihtiyacınız olacağından konu adını not edin. - Kaynak kodu bölümünde Satır içi düzenleyici'yi seçin.
index.jsbölümüne aşağıdaki kodu girin: Önceki kodda aşağıdakileri değiştirin:const firestore = require('@google-cloud/firestore'); const client = new firestore.v1.FirestoreAdminClient(); // Replace BUCKET_NAME const bucket = 'gs://BUCKET_NAME' exports.scheduledFirestoreExport = (event, context) => { // Access the GCLOUD_PROJECT environment variable set by the runtime. const projectId = process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT; // Use the DATABASE_ID environment variable if set, // otherwise default to '(default)' const databaseId = process.env.DATABASE_ID || '(default)'; const databaseName = client.databasePath( projectId, databaseId ); return client .exportDocuments({ name: databaseName, outputUriPrefix: bucket, // Leave collectionIds empty to export all collection groups // or define a list of collection group IDs: // collectionIds: ['users', 'posts'] collectionIds: [], }) .then(responses => { const response = responses[0]; console.log(`Operation Name: ${response['name']}`); return response; }) .catch(err => { console.error(err); }); };
BUCKET_NAMEyerine paketinizi adını yazın.-
Yalnızca belirtilen koleksiyon gruplarını dışa aktarmak için
collectionIds: []değerini değiştirin. Tüm koleksiyon gruplarını dışa aktarmak için olduğu gibi bırakın. -
(İsteğe bağlı) Varsayılan olmayan bir veritabanı kullanıyorsanız Cloud Functions işlevini oluştururken
DATABASE_IDortam değişkenini ayarladığınızdan emin olun.GOOGLE_CLOUD_PROJECTdeğerinin otomatik olarak ayarlanmadığı bir çalışma zamanı kullanıyorsanız bu değeri manuel olarak da ayarlamanız veya kodda proje kimliğinizle değiştirmeniz gerekebilir.
package.jsonaltında aşağıdaki bağımlılığı ekleyin:{ "dependencies": { "@google-cloud/firestore": "^1.3.0" } }- Yürütülecek işlev bölümüne
scheduledFirestoreExport,index.jsiçindeki işlevin adını girin. - Cloud Functions işlevini dağıtmak için Oluştur'u tıklayın.
Cloud Scheduler işi oluşturma
Ardından, Cloud Functions işlevinizi çağıran bir Cloud Scheduler işi oluşturun:
-
Google Cloud Console'da Cloud Scheduler sayfasına gidin:
Cloud Scheduler sitesine gidin
- İş Oluştur'u tıklayın.
- İş için
scheduledFirestoreExportgibi bir Ad girin. - Sıklık girin (ör.
every 24 hours). - Bir saat dilimi seçin.
- Hedef bölümünde Pub/Sub'ı seçin. Konu alanına, Cloud Functions işlevinizle birlikte tanımladığınız pub/sub konusunun adını girin. Bu ad, önceki örnekteki
initiateFirestoreExport'dir. - Payload (Yük) alanına
start exportgirin. İş için tanımlanmış bir yük gerekir ancak önceki Cloud Functions işlevi bu değeri kullanmaz. - Oluştur'u tıklayın.
Erişim izinlerini yapılandırma
Ardından, Cloud Function'a dışa aktarma işlemlerini başlatma ve GCS paketinize yazma izni verin.
Bu Cloud Run işlevi, kimlik doğrulaması yapmak ve dışa aktarma işlemlerini yetkilendirmek için bir hizmet hesabı kullanır. Kullanılan hizmet hesabı, Cloud Functions yapılandırmanıza bağlıdır:
- Cloud Functions (1. nesil): App Engine varsayılan
hizmet hesabını kullanır:
PROJECT_ID@appspot.gserviceaccount.com - Cloud Functions (2. nesil): Varsayılan Compute Engine
hizmet hesabını kullanır:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Bu hizmet hesabının, dışa aktarma işlemini başlatma ve Cloud Storage paketine yazma izni olmalıdır. Bu izinleri vermek için hizmet hesabına aşağıdaki IAM rollerini atayın:
Cloud Datastore Import Export Admin- Paketteki
Storage Adminrolü Cloud Run Invoker(2. nesil Cloud Functions'in tetikleme hizmetinin işlevi çağırmasına izin vermek için gereklidir)
Bu rolleri atamak için gcloud ve gsutil komut satırı araçlarını kullanabilirsiniz.
Henüz yüklenmediyse bu araçlara Google Cloud Console'daki Cloud Shell bölümünden erişebilirsiniz:
Başlayın Cloud Shell
-
Cloud Datastore İçe ve Dışa Aktarma Yöneticisi rolünü atayın. PROJECT_ID ve SERVICE_ACCOUNT (ör.
PROJECT_ID@appspot.gserviceaccount.comveyaPROJECT_NUMBER-compute@developer.gserviceaccount.com) yerine kendi değerlerinizi girin ve aşağıdaki komutu çalıştırın:gcloud projects add-iam-policy-binding PROJECT_ID \ --member serviceAccount:SERVICE_ACCOUNT \ --role roles/datastore.importExportAdmin -
Paketinizde Depolama Alanı Yöneticisi rolünü atayın. SERVICE_ACCOUNT ve BUCKET_NAME yerine kendi değerlerinizi girip aşağıdaki komutu çalıştırın:
gsutil iam ch serviceAccount:SERVICE_ACCOUNT:admin \ gs://BUCKET_NAME -
(Cloud Functions (2. nesil) için) Hizmet hesabına Cloud Run Invoker rolünü atayın. PROJECT_ID ve SERVICE_ACCOUNT yerine kendi değerlerinizi girip aşağıdaki komutu çalıştırın:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member serviceAccount:SERVICE_ACCOUNT \ --role roles/run.invoker
App Engine varsayılan hizmet hesabınızı devre dışı bırakır veya silerseniz App Engine uygulamanız Cloud Firestore veritabanınıza erişimi kaybeder. App Engine hizmet hesabınızı devre dışı bıraktıysanız yeniden etkinleştirebilirsiniz. Hizmet hesabını etkinleştirme başlıklı makaleyi inceleyin. App Engine hizmet hesabınızı son 30 gün içinde sildiyseniz hizmet hesabınızı geri yükleyebilirsiniz. Hizmet hesabını geri alma başlıklı makaleyi inceleyin.
Cloud Scheduler işinizi ve Cloud Functions işlevinizi test etme
Cloud Scheduler işinizi Google Cloud Console'un Cloud Scheduler sayfasında test edebilirsiniz.
Google Cloud Console'da Cloud Scheduler sayfasına gidin.
Cloud Scheduler sayfasına gidin.Yeni Cloud Scheduler işinizin satırında Şimdi çalıştır'ı tıklayın.
Birkaç saniye sonra Cloud Scheduler işi, sonuç sütununu Başarılı, Son çalıştırma sütununu ise geçerli saat olarak günceller. Yenile'yi tıklamanız gerekebilir.
Cloud Scheduler sayfası yalnızca işin Cloud Functions'ınızı çağırdığını onaylar. İşlevinizin günlüklerini görmek için Cloud Function sayfasını açın.
Cloud Functions günlüklerini görüntüleme
Cloud Functions'ın dışa aktarma işlemini başarıyla başlatıp başlatmadığını görmek için işlevin günlüklerini açın:
Firebase konsolu
Firebase konsolunda Hosting & Serverless (Hosting ve Sunucusuz) > Functions'a (İşlevler) gidin.
GCP Console
Google Cloud Console'da Cloud Functions sayfasına gidin.
Dışa aktarma işleminin ilerleme durumunu görüntüleme
Dışa aktarma işlemlerinizin ilerleme durumunu görüntülemek için gcloud firestore operations list komutunu kullanabilirsiniz. Dışa ve içe aktarma işlemlerini yönetme başlıklı makaleyi inceleyin.
Dışa aktarma işlemi tamamlandıktan sonra çıkış dosyalarını Cloud Storage paketinizde görüntüleyebilirsiniz:
Cloud Storage tarayıcısını açın.