Method: projects.table.export

یک فرآیند دسته ای را آغاز می کند که یک جدول را محاسبه می کند و نتیجه را در یکی از چندین مقصد می نویسد.

درخواست HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/table:export

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
project

string

شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب projects/{project-id} است.

مجوز نیاز به مجوز IAM زیر در project منبع مشخص شده دارد:

  • earthengine.exports.create

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
فیلدها
expression

object ( Expression )

عبارتی که برای محاسبه و صادرات به جدول ارزیابی می شود.

description

string

نام کار قابل خواندن برای انسان.

selectors[]

string

فهرست صریح ستون‌هایی که باید در نتیجه گنجانده شوند.

requestId

string

یک رشته منحصر به فرد که برای شناسایی درخواست های تکراری استفاده می شود. اگر بیش از یک درخواست توسط یک کاربر با همان requestId غیر خالی ارسال شود، تنها یکی از آن درخواست‌ها ممکن است با موفقیت یک عملیات طولانی‌مدت را آغاز کند. requestId ممکن است شامل کاراکترهای a..z، A..Z، 0-9 یا '-' باشد. requestId ممکن است حداکثر 60 کاراکتر باشد.

maxErrorMeters

number

هنگام تبدیل هندسه بین سیستم های مختصات ، خطای حداکثر در متر مجاز است. اگر خالی باشد، حداکثر خطا به طور پیش فرض 1 متر است.

maxVertices

integer

حداکثر تعداد رئوس برش نخورده در هر هندسه. هندسه با راس های بیشتر به قطعات کوچکتر از این اندازه برش داده می شود.

workloadTag

string

برچسب ارائه شده توسط کاربر برای ردیابی این محاسبات.

priority

integer

اختیاری. اولویت کار صادرات در پروژه. کارهای با اولویت بالاتر زودتر برنامه ریزی می شوند. باید یک عدد صحیح بین 0 و 9999 باشد. در صورت تنظیم نشدن، 100 پیش‌فرض است.

export_options فیلد اتحادیه . گزینه هایی که توصیف می کنند کجا و چگونه می توان نتایج را ذخیره کرد. export_options فقط می تواند یکی از موارد زیر باشد:
fileExportOptions

object ( TableFileExportOptions )

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

assetExportOptions

object ( TableAssetExportOptions )

در صورت مشخص شدن، صادرات را به عنوان دارایی Earth Engine پیکربندی می کند.

featureViewExportOptions

object ( FeatureViewAssetExportOptions )

در صورت مشخص شدن، صادرات را به عنوان نقشه FeatureView پیکربندی می کند.

bigqueryExportOptions

object ( BigQueryExportOptions )

در صورت مشخص شدن، صادرات داده های جدولی به BigQuery را پیکربندی می کند.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Operation است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

TableFileExportOptions

گزینه هایی برای صادرات جداول به عنوان فایل های خارج از Earth Engine.

نمایندگی JSON
{
  "fileFormat": enum (TableFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
فیلدها
fileFormat

enum ( TableFileFormat )

فرمت فایلی که در آن جدول(های) صادر می شود.

destination میدان اتحادیه کجا نتایج را بنویسیم destination فقط می تواند یکی از موارد زیر باشد:
driveDestination

object ( DriveDestination )

در صورت مشخص شدن، صادرات به Google Drive را پیکربندی می کند.

cloudStorageDestination

object ( CloudStorageDestination )

در صورت مشخص شدن، صادرات به Google Cloud Storage را پیکربندی می‌کند.

TableAssetExportOptions

گزینه هایی برای ذخیره جداول به عنوان دارایی Earth Engine.

نمایندگی JSON
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
فیلدها
destination میدان اتحادیه کجا نتایج را بنویسیم destination فقط می تواند یکی از موارد زیر باشد:
earthEngineDestination

object ( EarthEngineDestination )

در صورت مشخص شدن، صادرات به Earth Engine را پیکربندی می کند.

FeatureViewAssetExportOptions

گزینه هایی برای ذخیره جداول یا FeatureCollections به عنوان نقشه های FeatureView.

نمایندگی JSON
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

  // Union field destination can be only one of the following:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of list of possible types for union field destination.
}
فیلدها
ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

پارامترهای زمان مصرف FeatureView. این پارامترها باید در زمان مصرف مشخص شوند و نمی‌توانند در لحظه به‌روزرسانی شوند.

destination میدان اتحادیه کجا نتایج را بنویسیم destination فقط می تواند یکی از موارد زیر باشد:
featureViewDestination

object ( FeatureViewDestination )

در صورت مشخص شدن، صادرات به FeatureViews را پیکربندی می کند.

FeatureViewDestination

پیکربندی برای مقصد ویژگی نمای موتور زمین.

نمایندگی JSON
{
  "name": string,
  "assetVersion": integer
}
فیلدها
name

string

مورد نیاز. شناسه دارایی FeatureView. سرور یک نام نقشه را از شناسه تولید می کند.

assetVersion

integer

نسخه دارایی FeatureView برای ایجاد. برای نامگذاری نسخه های دارای دارایی استفاده می شود. اگر تنظیم نشود، 0 استفاده می شود.

BigQueryExportOptions

گزینه هایی برای صادرات داده های جدولی به BigQuery.

نمایندگی JSON
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
فیلدها
destination میدان اتحادیه محل نوشتن داده ها destination فقط می تواند یکی از موارد زیر باشد:
bigqueryDestination

object ( BigQueryDestination )

در صورت مشخص شدن، صادرات به BigQuery را پیکربندی می کند.

BigQueryDestination

پیکربندی برای یک مقصد در BigQuery.

نمایندگی JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
فیلدها
table

string

مورد نیاز. مرجع جدول مقصد BigQuery در قالب زیر: "projectId.dataset_id.table_id".

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

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

اگر منبع ارجاع شده وجود داشته باشد و طرحواره با منبع موجود سازگار نباشد، وظیفه نیز ناموفق خواهد بود.

overwrite

boolean

اگر جدول از قبل وجود داشته باشد و دارای یک طرحواره سازگار باشد ، داده های جدول را بازنویسی می کند.

پارامترهای overwrite و append نمی توانند همزمان true باشند.

append

boolean

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

پارامترهای overwrite و append نمی توانند همزمان true باشند.