Method: projects.table.export

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

คำขอ HTTP

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

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

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

number

ข้อผิดพลาดสูงสุดที่อนุญาตเป็นเมตรเมื่อเปลี่ยนรูปแบบเรขาคณิตระหว่างระบบพิกัด หากเว้นว่างไว้ ระบบจะกำหนดข้อผิดพลาดสูงสุดเป็น 1 เมตรโดยค่าเริ่มต้น
maxVertices

integer

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

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

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

การแสดง 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"

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

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

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

boolean

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

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

boolean

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

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