Method: projects.table.export

Bắt đầu một quy trình xử lý hàng loạt để tính toán một bảng và ghi kết quả vào một trong nhiều đí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 sẽ được coi là người dùng dịch vụ cho yêu cầu này. Định dạng là projects/{project-id}.

Việc uỷ quyền yêu cầu quyền IAM sau đây trên tài nguyên project đã chỉ định:

  • earthengine.exports.create

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có 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,

  // 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.
}
Trường
expression

object (Expression)

Biểu thức đánh giá bảng để tính toán và xuất.

description

string

Tên công việc mà con người đọc được.

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 thực hiện nhiều yêu cầu với cùng một requestId không trống, thì chỉ một trong các yêu cầu đó mới có thể bắt đầu thành công một thao tác chạy trong thời gian 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

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

maxVertices

integer

Số đỉ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.

Trường hợp hợp nhất export_options. Các tuỳ chọn mô tả vị trí và cách lưu trữ kết quả. export_options chỉ có thể là một trong những giá trị sau:
fileExportOptions

object (TableFileExportOptions)

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

assetExportOptions

object (TableAssetExportOptions)

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

featureViewExportOptions

object (FeatureViewAssetExportOptions)

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

bigqueryExportOptions

object (BigQueryExportOptions)

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

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 phiên bản 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 tuỳ 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),

  // 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.
}
Trường
fileFormat

enum (TableFileFormat)

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

Trường hợp hợp nhất destination. Vị trí ghi kết quả. destination chỉ có thể là một trong những giá trị sau:
driveDestination

object (DriveDestination)

Định cấu hình tính năng xuất sang Google Drive (nếu được chỉ định).

cloudStorageDestination

object (CloudStorageDestination)

Định cấu hình tính năng xuất sang Google Cloud Storage (nếu được chỉ định).

TableAssetExportOptions

Các tuỳ chọn để lưu bảng dưới dạng thành phần Earth Engine.

Biểu diễn dưới dạng JSON
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Trường
Trường hợp hợp nhất destination. Vị trí ghi kết quả. destination chỉ có thể là một trong những giá trị sau:
earthEngineDestination

object (EarthEngineDestination)

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

FeatureViewAssetExportOptions

Các tuỳ chọn để lưu bảng hoặc FeatureCollections dưới dạng bản đồ FeatureView.

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

object (FeatureViewIngestionTimeParameters)

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

Trường hợp hợp nhất destination. Vị trí ghi kết quả. destination chỉ có thể là một trong những giá trị sau:
featureViewDestination

object (FeatureViewDestination)

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

FeatureViewDestination

Cấu hình cho đí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ã thành phần FeatureView. Máy chủ tạo tên bản đồ từ mã nhận dạng.

assetVersion

integer

Phiên bản thành phần FeatureView cần tạo. Dùng để gán tên đại diện cho các phiên bản có tài sản. Nếu bạn không đặt, hệ thống sẽ sử dụng giá trị 0.

BigQueryExportOptions

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

Biểu diễn dưới dạng JSON
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Trường
Trường hợp hợp nhất destination. Vị trí ghi dữ liệu. destination chỉ có thể là một trong những giá trị sau:
bigqueryDestination

object (BigQueryDestination)

Định cấu hình tính năng xuất sang BigQuery (nếu được chỉ định).

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. Tham chiếu bảng đích BigQuery theo đị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 áp dụng nếu cả tham số "append" và "overwrite" đều sai.

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ố "overwrite" (ghi đè) và "append" (thêm vào) 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 có ghi đè dữ liệu bảng hay không nếu bảng đã tồn tại và có giản đồ tương thích.

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

append

boolean

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

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