Method: projects.table.export

מפעילה תהליך אצווה שמחשב טבלה וכותב את התוצאה לאחד מכמה יעדים.

בקשת HTTP

POST https://earthengine.googleapis.com/v1/{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,

  // 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

אופציונלי. העדיפות של משימת הייצוא בפרויקט. משימות בעדיפות גבוהה יותר מתוזמנות למועד מוקדם יותר. חייב להיות מספר שלם בין 0 ל-9999. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 100.
אפשרויות שמתארות איפה ואיך לאחסן את התוצאות. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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),

  // 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)

אם מציינים, מגדיר ייצוא ל-Google Cloud Storage.
סוף השדות הבלעדיים.

TableAssetExportOptions

אפשרויות לשמירת טבלאות כנכסי Earth Engine.

ייצוג 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.
סוף השדות הבלעדיים.

FeatureViewAssetExportOptions

אפשרויות לשמירת טבלאות או 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.

BigQueryExportOptions

אפשרויות לייצוא נתונים טבלאיים ל-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 צריך להיות true, אחרת המשימה תיכשל.

אם המשאב שאליו מתייחסים קיים והסכימה לא תואמת לסכימה הקיימת, המשימה תיכשל.
overwrite

boolean

ההגדרה קובעת אם להחליף את נתוני הטבלה אם הטבלה כבר קיימת ויש לה סכימה תואמת.

הפרמטרים overwrite ו-append לא יכולים להיות true בו-זמנית.
append

boolean

ההגדרה קובעת אם נתוני הטבלה יצורפו אם הטבלה כבר קיימת ויש לה סכימה תואמת.

הפרמטרים overwrite ו-append לא יכולים להיות true בו-זמנית.