Method: projects.table.export

เริ่มกระบวนการแบบกลุ่มที่คำนวณตารางและเขียนผลลัพธ์ไปยังปลายทางใดปลายทางหนึ่ง

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
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

สตริงที่ไม่ซ้ำกันซึ่งใช้เพื่อตรวจหาคำขอที่ซ้ำกัน หากผู้ใช้รายเดียวกันส่งคำขอมากกว่า 1 รายการโดยมี requestId เดียวกันซึ่งไม่ใช่ค่าว่าง ระบบจะอนุญาตให้คำขอเหล่านั้นเริ่มการดำเนินการที่ใช้เวลานานได้เพียง 1 รายการเท่านั้น requestId อาจมีอักขระ a..z, A..Z, 0-9 หรือ '-' requestId มีความยาวได้ไม่เกิน 60 อักขระ
maxErrorMeters

number

ข้อผิดพลาดสูงสุดที่อนุญาตเป็นเมตรเมื่อแปลงเรขาคณิตระหว่างระบบพิกัด หากเว้นว่างไว้ ข้อผิดพลาดสูงสุดจะเป็น 1 เมตรโดยค่าเริ่มต้น
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 ไดรฟ์
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

ตัวเลือกสำหรับการบันทึกตารางหรือ FeatureCollection เป็นแผนที่ 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

การกำหนดค่าสำหรับปลายทาง FeatureView ของ Earth Engine

การแสดง 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" เป็นเท็จทั้งคู่ด้วย

หากมีทรัพยากรที่อ้างอิงและมีสคีมาที่เข้ากันได้ พารามิเตอร์ "เขียนทับ" หรือ "ผนวก" อย่างใดอย่างหนึ่งต้องเป็นจริง ไม่เช่นนั้นงานจะล้มเหลว

หากมีทรัพยากรที่อ้างอิงและสคีมาไม่เข้ากันกับสคีมาที่มีอยู่ งานก็จะล้มเหลวเช่นกัน
overwrite

boolean

ระบุว่าจะเขียนทับข้อมูลตารางหรือไม่ หากมีตารางอยู่แล้วและมีสคีมาที่เข้ากันได้

พารามิเตอร์ overwrite และ append จะเป็น true พร้อมกันไม่ได้
append

boolean

ระบุว่าควรต่อท้ายข้อมูลตารางหรือไม่ หากตารางมีอยู่แล้วและมีสคีมาที่เข้ากันได้

พารามิเตอร์ overwrite และ append จะเป็น true พร้อมกันไม่ได้