Method: projects.table.export

Khởi tạo một quy trình hàng loạt để tính toán một bảng và ghi kết quả vào một trong số các đích đến.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
project

string

Mã dự án hoặc số dự án của dự án Google Cloud Platform cần được coi là người tiêu dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.

Để uỷ quyền, bạn cần có quyền IAM sau đây trên tài nguyên được chỉ định project:

  • earthengine.exports.create

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Trường
expression

object (Expression)

Một biểu thức được đánh giá thành bảng để tính toán và xuất.

description

string

Tên dễ đọc của việc cần làm.

selectors[]

string

Danh sách rõ ràng các cột cần đưa vào kết quả.

requestId

string

Một chuỗi duy nhất dùng để phát hiện các yêu cầu trùng lặp. Nếu cùng một người dùng đưa ra nhiều yêu cầu có cùng requestId không trống, thì chỉ một trong số các yêu cầu đó có thể bắt đầu thành công một thao tác kéo dài. requestId có thể chứa các ký tự a..z, A..Z, 0-9 hoặc "-". requestId có thể dài tối đa 60 ký tự.

maxErrorMeters

number

Sai số tối đa cho phép tính bằng mét khi chuyển đổi hình học giữa các hệ toạ độ. Nếu để trống, lỗi tối đa sẽ là 1 mét theo mặc định.

maxVertices

integer

Số lượng đỉnh tối đa chưa cắt trên mỗi hình học; các hình học có nhiều đỉnh hơn sẽ được cắt thành các phần nhỏ hơn kích thước này.

workloadTag

string

Nhãn do người dùng cung cấp để theo dõi phép tính này.

priority

integer

Không bắt buộc. Mức độ ưu tiên của tác vụ xuất trong dự án. Các tác vụ có mức độ ưu tiên cao hơn sẽ được lên lịch sớm hơn. Phải là số nguyên từ 0 đến 9999. Mặc định là 100 nếu không được đặt.

Các lựa chọn mô tả nơi và cách lưu trữ kết quả. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
fileExportOptions

object (TableFileExportOptions)

Nếu được chỉ định, hãy định cấu hình lệnh xuất dưới dạng một tệp.

assetExportOptions

object (TableAssetExportOptions)

Nếu được chỉ định, hãy định cấu hình xuất dưới dạng một tài sản Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Nếu được chỉ định, hãy định cấu hình xuất dưới dạng bản đồ FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Nếu được chỉ định, hãy định cấu hình hoạt động xuất dữ liệu dạng bảng sang BigQuery.

Kết thúc các trường xung khắc.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Operation.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.

TableFileExportOptions

Các lựa chọn để xuất bảng dưới dạng tệp bên ngoài Earth Engine.

Biểu diễn dưới dạng 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.
}
Trường
fileFormat

enum (TableFileFormat)

Định dạng tệp để xuất(các) bảng.

Nơi ghi kết quả. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
driveDestination

object (DriveDestination)

Nếu được chỉ định, hãy định cấu hình chế độ xuất sang Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

Nếu được chỉ định, hãy định cấu hình chế độ xuất sang Google Cloud Storage.

Kết thúc các trường xung khắc.

TableAssetExportOptions

Các lựa chọn để lưu bảng dưới dạng tài sản Earth Engine.

Biểu diễn dưới dạng 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.
}
Trường
Nơi ghi kết quả. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
earthEngineDestination

object (EarthEngineDestination)

Nếu được chỉ định, hãy định cấu hình chế độ xuất sang Earth Engine.

Kết thúc các trường xung khắc.

FeatureViewAssetExportOptions

Các lựa chọn để lưu bảng hoặc FeatureCollection dưới dạng bản đồ FeatureView.

Biểu diễn dưới dạng 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.
}
Trường
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Các tham số thời gian truyền FeatureView. Bạn phải chỉ định các tham số này tại thời điểm tiếp nhận và không thể cập nhật ngay lập tức.

Nơi ghi kết quả. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
featureViewDestination

object (FeatureViewDestination)

Nếu được chỉ định, hãy định cấu hình xuất sang FeatureViews.

Kết thúc các trường xung khắc.

FeatureViewDestination

Cấu hình cho một đích đến FeatureView của Earth Engine.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "assetVersion": integer
}
Trường
name

string

Bắt buộc. Mã tài sản FeatureView. Máy chủ tạo tên bản đồ từ mã nhận dạng.

assetVersion

integer

Phiên bản tài sản FeatureView cần tạo. Dùng để đặt tên thay thế cho các phiên bản có nội dung. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng giá trị 0.

BigQueryExportOptions

Các lựa chọn để xuất dữ liệu dạng bảng sang BigQuery.

Biểu diễn dưới dạng 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.
}
Trường
Nơi ghi dữ liệu. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
bigqueryDestination

object (BigQueryDestination)

Nếu được chỉ định, hãy định cấu hình chế độ xuất sang BigQuery.

Kết thúc các trường xung khắc.

BigQueryDestination

Cấu hình cho một đích đến trong BigQuery.

Biểu diễn dưới dạng JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Trường
table

string

Bắt buộc. Thông tin tham chiếu về bảng đích BigQuery ở định dạng sau: "projectId.dataset_id.table_id".

Nếu tài nguyên được tham chiếu không tồn tại, bảng mới sẽ được tạo. Điều này cũng áp dụng nếu cả tham số "append" và "overwrite" đều là false.

Nếu tài nguyên được tham chiếu tồn tại và có giản đồ tương thích, thì một trong các tham số "ghi đè" và "nối" phải là true, nếu không, tác vụ sẽ không thành công.

Nếu tài nguyên được tham chiếu tồn tại và giản đồ không tương thích với giản đồ hiện có, thì tác vụ cũng sẽ không thành công.

overwrite

boolean

Chỉ định xem dữ liệu bảng có nên bị ghi đè hay không nếu bảng đã tồn tại và có giản đồ tương thích.

Không thể đồng thời là true cho các tham số overwriteappend.

append

boolean

Chỉ định xem dữ liệu bảng có được thêm vào hay không nếu bảng đã tồn tại và có giản đồ tương thích.

Không thể đồng thời là true cho các tham số overwriteappend.