Method: projects.table.export

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
project

string

شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرف‌کننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
فیلدها
expression

object ( Expression )

عبارتی که برای محاسبه و خروجی گرفتن، به جدول ارزیابی می‌شود.

description

string

نامی برای وظیفه که برای انسان قابل خواندن باشد.

selectors[]

string

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

requestId

string

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

maxErrorMeters

number

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

maxVertices

integer

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

workloadTag

string

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

priority

integer

اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمان‌بندی می‌شوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیش‌فرض ۱۰۰ است.

گزینه‌هایی که محل و نحوه ذخیره نتایج را توصیف می‌کنند. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
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 .

گزینه‌های خروجی فایل جدول

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
fileFormat

enum ( TableFileFormat )

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

محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
driveDestination

object ( DriveDestination )

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

cloudStorageDestination

object ( CloudStorageDestination )

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

پایان میدان‌های ناسازگار.

گزینه‌های صادرات دارایی جدول

گزینه‌هایی برای ذخیره جداول به عنوان دارایی‌های موتور زمین.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
earthEngineDestination

object ( EarthEngineDestination )

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

پایان میدان‌های ناسازگار.

گزینه‌های FeatureViewAssetExport

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

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

محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
featureViewDestination

object ( FeatureViewDestination )

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

پایان میدان‌های ناسازگار.

FeatureViewDestination

پیکربندی برای یک مقصد Earth Engine FeatureView.

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

string

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

assetVersion

integer

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

گزینه‌های صادرات BigQuery

گزینه‌هایی برای خروجی گرفتن داده‌های جدولی به BigQuery.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
محل نوشتن داده‌ها. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
bigqueryDestination

object ( BigQueryDestination )

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

پایان میدان‌های ناسازگار.

BigQueryDestination

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

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

string

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

اگر منبع ارجاع‌شده وجود نداشته باشد، جدول جدید ایجاد خواهد شد. این موضوع در صورتی که پارامترهای "append" و "overwrite" هر دو false باشند نیز صدق می‌کند.

اگر منبع ارجاع‌شده وجود داشته باشد و طرحواره‌ی سازگار داشته باشد، یکی از پارامترهای "overwrite" و "append" باید درست باشد، در غیر این صورت وظیفه با شکست مواجه خواهد شد.

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

overwrite

boolean

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

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

append

boolean

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

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

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
project

string

شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرف‌کننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
فیلدها
expression

object ( Expression )

عبارتی که برای محاسبه و خروجی گرفتن، به جدول ارزیابی می‌شود.

description

string

نامی برای وظیفه که برای انسان قابل خواندن باشد.

selectors[]

string

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

requestId

string

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

maxErrorMeters

number

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

maxVertices

integer

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

workloadTag

string

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

priority

integer

اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمان‌بندی می‌شوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیش‌فرض ۱۰۰ است.

گزینه‌هایی که محل و نحوه ذخیره نتایج را توصیف می‌کنند. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
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 .

گزینه‌های خروجی فایل جدول

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
fileFormat

enum ( TableFileFormat )

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

محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
driveDestination

object ( DriveDestination )

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

cloudStorageDestination

object ( CloudStorageDestination )

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

پایان میدان‌های ناسازگار.

گزینه‌های صادرات دارایی جدول

گزینه‌هایی برای ذخیره جداول به عنوان دارایی‌های موتور زمین.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
earthEngineDestination

object ( EarthEngineDestination )

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

پایان میدان‌های ناسازگار.

گزینه‌های FeatureViewAssetExport

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "featureViewDestination": {
    object (FeatureViewDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

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

محل نوشتن نتایج. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
featureViewDestination

object ( FeatureViewDestination )

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

پایان میدان‌های ناسازگار.

FeatureViewDestination

پیکربندی برای یک مقصد Earth Engine FeatureView.

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

string

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

assetVersion

integer

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

گزینه‌های صادرات BigQuery

گزینه‌هایی برای خروجی گرفتن داده‌های جدولی به BigQuery.

نمایش JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
فیلدها
محل نوشتن داده‌ها. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
bigqueryDestination

object ( BigQueryDestination )

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

پایان میدان‌های ناسازگار.

BigQueryDestination

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

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

string

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

اگر منبع ارجاع‌شده وجود نداشته باشد، جدول جدید ایجاد خواهد شد. این موضوع در صورتی که پارامترهای "append" و "overwrite" هر دو false باشند نیز صدق می‌کند.

اگر منبع ارجاع‌شده وجود داشته باشد و طرحواره‌ی سازگار داشته باشد، یکی از پارامترهای "overwrite" و "append" باید درست باشد، در غیر این صورت وظیفه با شکست مواجه خواهد شد.

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

overwrite

boolean

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

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

append

boolean

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

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