واردات و صادرات داده ها

فقط مربوط به Cloud Firestore Enterprise edition.

می‌توانید از سرویس صادرات و واردات مدیریت‌شده برای بازیابی از حذف تصادفی داده‌ها و صادرات داده‌ها برای پردازش آفلاین استفاده کنید. شما می توانید تمام اسناد یا فقط مجموعه های خاص را صادر کنید. به همین ترتیب، می توانید تمام داده ها را از یک صادرات یا فقط مجموعه های خاص وارد کنید. داده های صادر شده از یک Cloud Firestore با پایگاه داده سازگاری MongoDB را می توان به Cloud Firestore دیگر با پایگاه داده سازگاری MongoDB وارد کرد. همچنین می‌توانید Cloud Firestore را با صادرات سازگاری MongoDB در BigQuery بارگیری کنید .

در این صفحه نحوه صادرات و وارد کردن Cloud Firestore با اسناد سازگاری MongoDB با استفاده از سرویس صادرات و واردات مدیریت شده و Cloud Storage توضیح داده شده است. سرویس صادرات و واردات مدیریت شده Cloud Firestore با سازگاری MongoDB از طریق ابزار خط فرمان gcloud و Cloud Firestore با سازگاری MongoDB API ( REST ، RPC ) در دسترس است.

احتیاط: صادرات داده از Cloud Firestore با سازگاری MongoDB یک عملیات خواندن در هر سند صادر شده را متحمل می شود. با این حال، این خواندن ها در بخش استفاده از کنسول ظاهر نمی شوند. قبل از تنظیم صادرات مکرر، مطمئن شوید که این را درک کرده اید تا از صورتحساب غیرمنتظره جلوگیری کنید.

قبل از شروع

قبل از اینکه بتوانید از سرویس صادرات و واردات مدیریت شده استفاده کنید، باید کارهای زیر را انجام دهید:

1. صورتحساب پروژه Google Cloud خود را فعال کنید. فقط پروژه های Google Cloud با فعال بودن صورتحساب می توانند از عملکرد صادرات و واردات استفاده کنند.
2. یک سطل Cloud Storage برای پروژه خود در مکانی نزدیک به Cloud Firestore با موقعیت پایگاه داده سازگاری MongoDB ایجاد کنید. شما نمی توانید از سطل Requester Pays برای عملیات صادرات و واردات استفاده کنید.

3. مطمئن شوید که حساب شما دارای مجوزهای لازم برای Cloud Firestore با سازگاری MongoDB و Cloud Storage است. اگر شما مالک پروژه هستید، حساب شما دارای مجوزهای لازم است. در غیر این صورت، نقش‌های زیر مجوزهای لازم را برای عملیات صادرات و واردات و دسترسی به Cloud Storage می‌دهند:

   • Cloud Firestore با نقش‌های سازگاری MongoDB: Owner ، Cloud Datastore Owner یا Cloud Datastore Import Export Admin
     توجه: این نقش‌های Datastore در Cloud Firestore با سازگاری MongoDB نیز مجوز می‌دهند.

   • نقش‌های Cloud Storage : Owner یا Storage Admin

مجوزهای عامل خدمات

عملیات صادرات و واردات از یک عامل خدمات Cloud Firestore برای مجاز کردن عملیات Cloud Storage استفاده می کند. عامل خدمات Cloud Firestore از قرارداد نامگذاری زیر استفاده می کند:

عامل خدمات Cloud Firestore

service- PROJECT_NUMBER @gcp-sa-firestore.iam.gserviceaccount.com

برای اطلاعات بیشتر در مورد نمایندگی های خدمات، به نمایندگی های خدمات مراجعه کنید.

توجه: Cloud Firestore قبلاً از حساب سرویس پیش‌فرض App Engine به جای عامل سرویس Cloud Firestore استفاده می‌کرد. اگر پایگاه داده شما همچنان از حساب سرویس App Engine برای وارد کردن یا صادر کردن داده‌ها استفاده می‌کند، توصیه می‌کنیم به نمایندگی سرویس Cloud Firestore خاص سرویس مهاجرت کنید . می‌توانید مشاهده کنید که عملیات واردات و صادرات از کدام حساب در کنسول Google Cloud استفاده می‌کند .

اگر از کنترل‌های سرویس VPC استفاده می‌کنید، باید از عامل سرویس Cloud Firestore مخصوص سرویس برای محافظت کامل از عملیات واردات و صادرات استفاده کنید. کنترل های سرویس VPC با حساب سرویس App Engine سازگار نیست.

عامل خدمات Cloud Firestore نیاز به دسترسی به سطل Cloud Storage مورد استفاده در عملیات صادرات یا واردات دارد. اگر سطل Cloud Storage شما در پروژه ای مشابه با پایگاه داده Cloud Firestore شما قرار دارد، در این صورت عامل سرویس Cloud Firestore می تواند به طور پیش فرض به سطل دسترسی داشته باشد .

اگر سطل Cloud Storage در پروژه دیگری است، باید به عامل سرویس Cloud Firestore دسترسی به سطل Cloud Storage بدهید.

نقش ها را به عامل خدمات اختصاص دهید

می توانید از ابزار خط فرمان gsutil برای اختصاص یکی از نقش های زیر استفاده کنید. به عنوان مثال، برای اختصاص نقش مدیریت ذخیره‌سازی به عامل سرویس Cloud Firestore ، موارد زیر را اجرا کنید:

gsutil iam ch serviceAccount:[e-mail]:roles/storage.admin \
    gs://[BUCKET_NAME]

شماره پروژه خود را جایگزین PROJECT_NUMBER کنید، که برای نام‌گذاری عامل سرویس Cloud Firestore شما استفاده می‌شود. برای مشاهده نام عامل سرویس، مشاهده نام عامل سرویس را ببینید.

همچنین، می‌توانید این نقش را با استفاده از کنسول Google Cloud اختصاص دهید .

مشاهده نام عامل خدمات

می‌توانید حسابی را که عملیات واردات و صادرات شما برای تأیید درخواست‌ها از صفحه واردات/صادرات در کنسول Google Cloud استفاده می‌کند، مشاهده کنید. همچنین می توانید مشاهده کنید که آیا پایگاه داده شما از عامل سرویس Cloud Firestore استفاده می کند یا از حساب سرویس App Engine قدیمی.

1. حساب مجوز را در کنار کارهای واردات/صادرات اجرا شده به عنوان برچسب مشاهده کنید.

عامل سرویس به نقش Storage Admin برای سطل Cloud Storage نیاز دارد تا برای عملیات صادرات یا واردات استفاده شود.

gcloud برای پروژه خود راه اندازی کنید

می‌توانید عملیات واردات و صادرات را از طریق کنسول Google Cloud یا ابزار خط فرمان gcloud آغاز کنید. برای استفاده از gcloud ، ابزار خط فرمان را راه اندازی کرده و به یکی از روش های زیر به پروژه خود متصل شوید:

• با استفاده از Cloud Shell از کنسول Google Cloud gcloud دسترسی پیدا کنید.

  Cloud Shell را راه اندازی کنید

  مطمئن شوید که gcloud برای پروژه صحیح پیکربندی شده است:

  gcloud config set project [PROJECT_ID]
  

• Google Cloud SDK را نصب و مقداردهی اولیه کنید.

داده ها را وارد کنید

هنگامی که فایل‌های صادراتی را در Cloud Storage دارید، می‌توانید اسناد موجود در آن فایل‌ها را دوباره به پروژه خود یا پروژه دیگری وارد کنید. در مورد عملیات واردات به نکات زیر توجه کنید:

• هنگامی که داده ها را وارد می کنید، نمایه های مورد نیاز با استفاده از تعاریف شاخص فعلی پایگاه داده شما به روز می شوند. صادرات شامل تعاریف شاخص نیست.

• واردات شناسه‌های سند جدید اختصاص نمی‌دهد. واردات از شناسه هایی استفاده می کند که در زمان صادرات ثبت شده است. همانطور که یک سند در حال وارد شدن است، شناسه آن برای جلوگیری از برخورد شناسه رزرو شده است. اگر سندی با همان شناسه از قبل وجود داشته باشد، واردات سند موجود را بازنویسی می‌کند.

• اگر سندی در پایگاه داده شما تحت تأثیر واردات قرار نگیرد، پس از وارد کردن در پایگاه داده شما باقی خواهد ماند.

• نام فایل .overall_export_metadata باید با نام پوشه والد آن مطابقت داشته باشد:

  gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/ PARENT_FOLDER_NAME / PARENT_FOLDER_NAME .overall_export_metadata

  اگر فایل‌های خروجی یک صادرات را منتقل یا کپی می‌کنید، نام فایل PARENT_FOLDER_NAME و .overall_export_metadata را یکسان نگه دارید.

• وارد کردن به یک Cloud Firestore با پایگاه داده سازگاری MongoDB از صادرات با مجموعه‌های فرعی انجام نمی‌شود زیرا مجموعه‌های فرعی در Cloud Firestore با سازگاری MongoDB پشتیبانی نمی‌شوند.

• وارد کردن به پایگاه داده نسخه استاندارد Cloud Firestore از صادرات با انواع BSON انجام نمی شود زیرا انواع BSON در نسخه استاندارد Cloud Firestore پشتیبانی نمی شود.

• وارد کردن به یک Cloud Firestore با پایگاه داده سازگاری MongoDB نمی‌تواند داده‌ها را از فضاهای نام غیر پیش‌فرض ( Datastore API) وارد کند.

  وارد کردن به یک Cloud Firestore با پایگاه‌داده سازگاری MongoDB از فایل‌های داده‌ای که حاوی فضای نام غیر پیش‌فرض هستند، تنها در صورتی مجاز است که عملیات صادرات شامل فیلتر --namespace-ids با فضای نام پیش‌فرض باشد. فقط داده ها از فضای نام پیش فرض وارد می شوند.

تمام اسناد را از یک صادرات وارد کنید

Google Cloud Console

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. یک پایگاه داده را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

4. روی Import کلیک کنید.

5. در قسمت Filename ، نام فایل یک فایل .overall_export_metadata را از یک عملیات صادرات تکمیل شده وارد کنید. می توانید از دکمه Browse برای انتخاب فایل استفاده کنید.

6. روی Import کلیک کنید.

کنسول به صفحه Import/Export باز می گردد. اگر عملیات با موفقیت شروع شود، صفحه ورودی به صفحه واردات و صادرات اخیر اضافه می کند. در صورت خرابی، صفحه یک پیغام خطا نمایش می دهد.

gcloud

از دستور firestore import برای وارد کردن اسناد از عملیات صادرات قبلی استفاده کنید.

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]

موارد زیر را جایگزین کنید:

• BUCKET_NAME/EXPORT_PREFIX : مکان فایل های صادراتی شما.

• DATABASE : نام پایگاه داده.

به عنوان مثال:

gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'

می‌توانید مکان فایل‌های صادراتی خود را در مرورگر Cloud Storage در کنسول Google Cloud تأیید کنید:

مرورگر Cloud Storage باز کنید

هنگامی که عملیات واردات را شروع می کنید، بستن پایانه عملیات را لغو نمی کند، به لغو عملیات مراجعه کنید.

واردات مجموعه های خاص

توجه: برای وارد کردن مجموعه‌های خاص، باید از خروجی یک عملیات صادراتی استفاده کنید که در آن مجموعه‌های خاصی را صادر کرده‌اید .

Google Cloud Console

شما نمی توانید مجموعه های خاصی را در کنسول انتخاب کنید. به جای آن از gcloud استفاده کنید.

gcloud

برای وارد کردن مجموعه های خاص از مجموعه ای از فایل های صادراتی، از پرچم --collection-ids استفاده کنید. این عملیات فقط مجموعه هایی را با شناسه های مجموعه داده شده وارد می کند. نام پایگاه داده را با استفاده از پرچم --database مشخص کنید.

فقط صادرات مجموعه های خاص از واردات مجموعه های خاص پشتیبانی می کند. شما نمی توانید مجموعه های خاصی را از صادرات همه اسناد وارد کنید.

  gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ \
  --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2] \
  --database=[DATABASE]

واردات از یک صادرات با داده های PITR

برای وارد کردن داده های PITR از همان مراحلی که در Import all document یا Import special collections استفاده می کنید، استفاده کنید. اگر سندی از قبل در پایگاه داده شما وجود داشته باشد، بازنویسی می شود.

صادرات داده ها

عملیات صادرات اسناد موجود در پایگاه داده شما را به مجموعه ای از فایل ها در یک سطل Cloud Storage کپی می کند. توجه داشته باشید که صادرات یک عکس فوری پایگاه داده دقیق نیست که در زمان شروع صادرات گرفته شده است. صادرات ممکن است شامل تغییراتی باشد که در حین اجرای عملیات انجام شده است.

توجه: اگر قصد دارید مجموعه‌های خاصی را صادر کنید :

• فقط مجموعه های خاص را وارد کنید
• Cloud Firestore را با داده های سازگاری MongoDB در BigQuery بارگیری کنید

صادرات تمام اسناد

Google Cloud Console

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

4. صادرات را کلیک کنید.

5. روی گزینه Export whole database کلیک کنید.

6. صادرات وضعیت فعلی پایگاه داده را برای صادرات داده های فعلی انتخاب کنید.

7. در قسمت Destination نام یک سطل Cloud Storage را وارد کنید یا از دکمه Browse برای انتخاب یک سطل استفاده کنید.

8. صادرات را کلیک کنید.

کنسول به صفحه Import/Export باز می گردد. اگر عملیات با موفقیت شروع شود، صفحه ورودی به صفحه واردات و صادرات اخیر اضافه می کند. در صورت خرابی، صفحه یک پیغام خطا نمایش می دهد.

gcloud

از فرمان firestore export برای صادر کردن تمام اسناد موجود در پایگاه داده خود استفاده کنید و نام سطل Cloud Storage خود را جایگزین [BUCKET_NAME] کنید. برای جلوگیری از منتظر ماندن ابزار gcloud برای تکمیل عملیات، پرچم --async را اضافه کنید.

  gcloud firestore export gs://[BUCKET_NAME] \
  --database=[DATABASE]

موارد زیر را جایگزین کنید:

• BUCKET_NAME : با افزودن یک پیشوند فایل پس از نام سطل، صادرات خود را سازماندهی کنید، به عنوان مثال، BUCKET_NAME/my-exports-folder/export-name . اگر پیشوند فایلی ارائه نکنید، سرویس صادرات مدیریت شده یک پیشوند را براساس مهر زمانی فعلی ایجاد می‌کند.

• DATABASE : نام پایگاه داده ای که می خواهید اسناد را از آن صادر کنید.

هنگامی که عملیات صادرات را شروع می کنید، بستن پایانه عملیات را لغو نمی کند، به لغو عملیات رجوع کنید.

صادرات مجموعه های خاص

Google Cloud Console

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

4. صادرات را کلیک کنید.

5. روی گزینه Export one or more collection group کلیک کنید. از منوی کشویی برای انتخاب یک یا چند مجموعه استفاده کنید.

6. صادرات وضعیت فعلی پایگاه داده را برای صادرات داده های فعلی انتخاب کنید.

7. در قسمت Destination نام یک سطل Cloud Storage را وارد کنید یا از دکمه Browse برای انتخاب یک سطل استفاده کنید.

8. صادرات را کلیک کنید.

کنسول به صفحه Import/Export باز می گردد. اگر عملیات با موفقیت شروع شود، صفحه ورودی به صفحه واردات و صادرات اخیر اضافه می کند. در صورت خرابی، صفحه یک پیغام خطا نمایش می دهد.

gcloud

برای صادرات مجموعه های خاص، از پرچم --collection-ids استفاده کنید. این عملیات فقط مجموعه هایی را با شناسه مجموعه داده شده صادر می کند.

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2] \
--database=[DATABASE]

به عنوان مثال، می‌توانید مجموعه‌ای از restaurants را در پایگاه داده foo طراحی کنید تا مجموعه‌های اضافی مانند ratings ، reviews یا outlets را در بر بگیرد. برای صادر کردن restaurants و reviews مجموعه خاص، دستور شما به صورت زیر است:

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=restaurants,reviews \
--database='cymbal'

صادرات از یک مهر زمانی PITR

می توانید پایگاه داده خود را از داده های PITR به Cloud Storage صادر کنید. می‌توانید داده‌های PITR را در جایی صادر کنید که مُهر زمانی یک مهر زمانی کامل در هفت روز گذشته باشد، اما نه زودتر از earliestVersionTime . اگر داده ها دیگر در مهر زمانی مشخص شده وجود نداشته باشند، عملیات صادرات با شکست مواجه می شود.

عملیات صادرات PITR از همه فیلترها، از جمله صادرات همه اسناد و صادرات مجموعه های خاص، پشتیبانی می کند.

قبل از صدور داده های PITR به نکات زیر توجه کنید:

• مهر زمانی را در قالب RFC 3339 مشخص کنید. به عنوان مثال، 2020-09-01T23:59:30.234233Z .
• مطمئن شوید که مهر زمانی که مشخص می‌کنید یک مهر زمانی کامل در هفت روز گذشته باشد، اما نه زودتر از earliestVersionTime . اگر داده ها دیگر در مهر زمانی مشخص شده وجود نداشته باشند، یک خطا ایجاد می شود.
• برای صادرات ناموفق PITR هزینه ای از شما دریافت نمی شود.

کنسول

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید
2. یک پایگاه داده را از لیست پایگاه های داده انتخاب کنید.
3. در منوی پیمایش، روی Import/Export کلیک کنید.
4. صادرات را کلیک کنید.
5. منبع صادرات را برای صادر کردن کل پایگاه داده یا فقط مجموعه های خاص پیکربندی کنید.

6. در قسمت Choose the state of your database to export ، Export from an older point in time را انتخاب کنید.

   یک زمان عکس فوری را برای استفاده برای صادرات انتخاب کنید

7. در قسمت Destination نام یک سطل Cloud Storage را وارد کنید یا از دکمه Browse برای انتخاب یک سطل استفاده کنید.

8. صادرات را کلیک کنید.

   کنسول به صفحه Import/Export باز می گردد. اگر عملیات با موفقیت شروع شود، صفحه ورودی به صفحه واردات و صادرات اخیر اضافه می کند. در صورت خرابی، صفحه یک پیغام خطا نمایش می دهد.

gcloud

با استفاده از دستور gcloud firestore export می توانید پایگاه داده خود را از داده های PITR به Cloud Storage صادر کنید.

پایگاه داده را با مشخص کردن پارامتر snapshot-time به یک مهر زمانی بازیابی صادر کنید. دستور زیر را اجرا کنید تا پایگاه داده به سطل خود صادر کنید.

gcloud firestore export gs://[BUCKET_NAME_PATH] \
    --snapshot-time=[PITR_TIMESTAMP]

جایی که PITR_TIMESTAMP یک مهر زمانی PITR در جزئیات دقیقه است، برای مثال، 2023-05-26T10:20:00.00Z .

برای صادرات مجموعه های خاص، پرچم --collection-ids را اضافه کنید.

مدیریت عملیات صادرات و واردات

پس از شروع یک عملیات صادرات یا واردات، Cloud Firestore با سازگاری MongoDB به عملیات یک نام منحصر به فرد اختصاص می دهد. می توانید از نام عملیات برای حذف، لغو یا بررسی وضعیت استفاده کنید.

نام عملیات با projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/ پیشوند است، برای مثال:

projects/my-project/databases/my-database/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

با این حال، هنگام تعیین نام عملیات برای دستورات describe ، cancel و delete ، می توانید پیشوند را کنار بگذارید.

لیست کلیه عملیات صادرات و واردات

Google Cloud Console

می‌توانید فهرستی از عملیات‌های صادرات و واردات اخیر را در صفحه واردات/صادرات کنسول Google Cloud مشاهده کنید.

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

gcloud

از دستور operations list برای مشاهده تمام عملیات صادرات و واردات در حال اجرا و اخیراً تکمیل شده استفاده کنید:

gcloud firestore operations list

وضعیت عملکرد را بررسی کنید

Google Cloud Console

می‌توانید وضعیت یک عملیات صادرات یا واردات اخیر را در صفحه واردات/صادرات کنسول Google Cloud مشاهده کنید.

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

gcloud

برای نشان دادن وضعیت یک عملیات صادرات یا واردات از دستور operations describe استفاده کنید.

gcloud firestore operations describe [OPERATION_NAME]

زمان تکمیل را تخمین بزنید

درخواست برای وضعیت یک عملیات طولانی مدت، معیارهای workEstimated و workCompleted را برمی گرداند. هر یک از این معیارها هم در تعداد بایت و هم تعداد موجودیت ها برگردانده می شود:

• workEstimated تعداد کل تخمینی بایت ها و اسنادی را که یک عملیات پردازش می کند را نشان می دهد. اگر نتواند تخمین بزند، Cloud Firestore با سازگاری MongoDB ممکن است این معیار را حذف کند.

• workCompleted تعداد بایت ها و اسناد پردازش شده را نشان می دهد. پس از اتمام عملیات، مقدار تعداد کل بایت‌ها و اسنادی را نشان می‌دهد که واقعاً پردازش شده‌اند، که ممکن است بزرگتر از مقدار workEstimated باشد.

تقسیم workCompleted بر workEstimated برای تخمین پیشرفت تقریبی. این تخمین ممکن است نادرست باشد، زیرا به تأخیر در جمع آوری آمار بستگی دارد.

یک عملیات را لغو کنید

Google Cloud Console

می‌توانید یک عملیات صادرات یا واردات در حال اجرا را در صفحه واردات/صادرات کنسول Google Cloud لغو کنید.

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Import/Export کلیک کنید.

در جدول واردات و صادرات اخیر ، عملیات در حال اجرا شامل یک دکمه لغو در ستون تکمیل شده است . روی دکمه Cancel کلیک کنید تا عملیات متوقف شود. دکمه به یک پیام لغو و سپس با توقف کامل عملیات به لغو تغییر می کند.

gcloud

از دستور operations cancel برای توقف عملیات در حال انجام استفاده کنید:

gcloud firestore operations cancel [OPERATION_NAME]

لغو یک عملیات در حال اجرا، عملیات را لغو نمی کند. عملیات صادرات لغو شده اسنادی را که قبلاً در Cloud Storage صادر شده اند باقی می گذارد و عملیات واردات لغو شده به روز رسانی هایی را که قبلاً در پایگاه داده شما انجام شده است باقی می گذارد. شما نمی توانید یک صادرات نیمه تکمیل شده را وارد کنید.

یک عملیات را حذف کنید

برای حذف یک عملیات از لیست عملیات اخیر، از دستور gcloud firestore operations delete استفاده کنید. این دستور فایل های صادراتی را از Cloud Storage حذف نمی کند.

gcloud firestore operations delete [OPERATION_NAME]

صورتحساب و قیمت گذاری برای عملیات صادرات و واردات

قبل از استفاده از خدمات صادرات و واردات مدیریت شده، باید صورتحساب پروژه Google Cloud خود را فعال کنید.

عملیات صادرات و واردات برای واحدهای خواندن و نوشتن با نرخ‌های ذکر شده در Cloud Firestore با قیمت‌گذاری سازگاری MongoDB محاسبه می‌شود.

فایل های خروجی ذخیره شده در Cloud Storage جزء هزینه های ذخیره سازی داده Cloud Storage شما محسوب می شود.

عملیات صادرات یا وارد کردن، هشدارهای بودجه Google Cloud شما را تا پس از تکمیل فعال نمی‌کند. عملیات صادرات و واردات بر استفاده نشان داده شده در بخش استفاده از کنسول تأثیری نخواهد داشت.

مشاهده هزینه های صادرات و واردات

عملیات صادرات و واردات، برچسب goog-firestoremanaged:exportimport برای عملیات صورت‌حساب اعمال می‌کند. در صفحه گزارش‌های صورت‌حساب ابری ، می‌توانید از این برچسب برای مشاهده هزینه‌های مربوط به عملیات واردات و صادرات استفاده کنید:

توجه: عملیات صادرات و واردات انجام شده قبل از 8 سپتامبر 2020 برچسب goog-firestoremanaged را اعمال نکرده است.

صادرات به BigQuery

می‌توانید داده‌ها را از یک Cloud Firestore با صادرات سازگاری MongoDB در BigQuery بارگیری کنید، اما فقط در صورتی که فیلتر collection-ids را مشخص کرده باشید. به بارگیری داده ها از Cloud Firestore با صادرات سازگاری MongoDB مراجعه کنید.

هنگام بارگیری Cloud Firestore با داده‌های سازگاری MongoDB در BigQuery، انواع داده‌های BSON با نوع داده STRING نشان داده می‌شوند.

محدودیت ستون BigQuery

BigQuery محدودیت 10000 ستون در هر جدول را اعمال می کند. Cloud Firestore با عملیات صادرات سازگاری MongoDB یک طرح جدول BigQuery برای هر مجموعه ایجاد می کند. در این طرح، هر نام فیلد منحصربه‌فرد در یک مجموعه به یک ستون طرحواره تبدیل می‌شود.

اگر طرح BigQuery مجموعه‌ای از 10000 ستون فراتر رود، عملیات صادرات Cloud Firestore با سازگاری MongoDB سعی می‌کند با در نظر گرفتن فیلدهای نقشه به‌عنوان بایت، زیر حد ستون باقی بماند. اگر این تبدیل تعداد ستون‌ها را به کمتر از 10000 برساند، می‌توانید داده‌ها را در BigQuery بارگیری کنید، اما نمی‌توانید زیر فیلدهای داخل فیلدهای نقشه را جستجو کنید. اگر تعداد ستون‌ها همچنان از 10000 بیشتر باشد، عملیات صادرات طرحی BigQuery برای مجموعه ایجاد نمی‌کند و نمی‌توانید داده‌های آن را در BigQuery بارگیری کنید.

فرمت و فایل های ابرداده را صادر کنید

خروجی یک صادرات مدیریت شده از فرمت گزارش LevelDB استفاده می کند.

فایل های فراداده

یک عملیات صادرات یک فایل فراداده برای هر مجموعه ای که شما مشخص می کنید ایجاد می کند. فایل‌های فراداده معمولاً ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata نام دارند.

فایل های ابرداده بافرهای پروتکل هستند و می توانید آنها را با protoc پروتکل رمزگشایی کنید. به عنوان مثال، می‌توانید یک فایل فراداده را رمزگشایی کنید تا مجموعه‌هایی را که فایل‌های صادراتی حاوی آن هستند، تعیین کنید:

protoc --decode_raw < export0.export_metadata