Method: projects.table.export

Memulai proses batch yang menghitung tabel dan menulis hasilnya ke salah satu dari beberapa tujuan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
project

string

ID project atau nomor project Google Cloud Platform yang harus diperlakukan sebagai konsumen layanan untuk permintaan ini. Format adalah projects/{project-id}.

Otorisasi memerlukan izin IAM berikut pada project resource yang ditentukan:

  • earthengine.exports.create

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
expression

object (Expression)

Ekspresi yang dievaluasi ke tabel yang akan dihitung dan diekspor.

description

string

Nama tugas yang dapat dibaca manusia.

selectors[]

string

Daftar eksplisit kolom yang akan disertakan dalam hasil.

requestId

string

String unik yang digunakan untuk mendeteksi permintaan yang diduplikasikan. Jika lebih dari satu permintaan dibuat oleh pengguna yang sama dengan requestId yang sama dan tidak kosong, hanya salah satu permintaan tersebut yang dapat berhasil memulai operasi yang berjalan lama. requestId dapat berisi karakter a..z, A..Z, 0-9, atau '-'. Panjang requestId maksimal 60 karakter.

maxErrorMeters

number

Error maksimum yang diizinkan dalam meter saat mentransformasi geometri antara sistem koordinat. Jika kosong, error maksimum adalah 1 meter secara default.

maxVertices

integer

Jumlah maksimum verteks yang tidak dipotong per geometri; geometri dengan lebih banyak verteks akan dipotong menjadi beberapa bagian yang lebih kecil dari ukuran ini.

workloadTag

string

Label yang diberikan pengguna untuk melacak komputasi ini.

priority

integer

Opsional. Prioritas tugas ekspor dalam project. Tugas dengan prioritas lebih tinggi dijadwalkan lebih awal. Harus berupa bilangan bulat antara 0 dan 9999. Jika tidak ditetapkan, defaultnya adalah 100.

Opsi yang menjelaskan tempat dan cara menyimpan hasil. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
fileExportOptions

object (TableFileExportOptions)

Jika ditentukan, mengonfigurasi ekspor sebagai file.

assetExportOptions

object (TableAssetExportOptions)

Jika ditentukan, mengonfigurasi ekspor sebagai aset Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Jika ditentukan, mengonfigurasi ekspor sebagai peta FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Jika ditentukan, mengonfigurasi ekspor data tabular ke BigQuery.

Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons memuat instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

TableFileExportOptions

Opsi untuk mengekspor tabel sebagai file di luar Earth Engine.

Representasi 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.
}
Kolom
fileFormat

enum (TableFileFormat)

Format file untuk mengekspor tabel.

Tempat untuk menulis hasil. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
driveDestination

object (DriveDestination)

Jika ditentukan, mengonfigurasi ekspor ke Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

Jika ditentukan, mengonfigurasi ekspor ke Google Cloud Storage.

Akhir kolom yang saling eksklusif.

TableAssetExportOptions

Opsi untuk menyimpan tabel sebagai aset Earth Engine.

Representasi 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.
}
Kolom
Tempat untuk menulis hasil. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
earthEngineDestination

object (EarthEngineDestination)

Jika ditentukan, mengonfigurasi ekspor ke Earth Engine.

Akhir kolom yang saling eksklusif.

FeatureViewAssetExportOptions

Opsi untuk menyimpan tabel atau FeatureCollection sebagai peta FeatureView.

Representasi 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.
}
Kolom
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Parameter waktu penyerapan FeatureView. Parameter ini harus ditentukan pada waktu penyerapan dan tidak dapat diperbarui secara langsung.

Tempat untuk menulis hasil. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
featureViewDestination

object (FeatureViewDestination)

Jika ditentukan, mengonfigurasi ekspor ke FeatureView.

Akhir kolom yang saling eksklusif.

FeatureViewDestination

Konfigurasi untuk tujuan FeatureView Earth Engine.

Representasi JSON
{
  "name": string,
  "assetVersion": integer
}
Kolom
name

string

Wajib. ID aset FeatureView. Server membuat nama peta dari ID.

assetVersion

integer

Versi aset FeatureView yang akan dibuat. Digunakan untuk membuat alias versi dengan aset. Jika tidak disetel, 0 akan digunakan.

BigQueryExportOptions

Opsi untuk mengekspor data tabular ke BigQuery.

Representasi 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.
}
Kolom
Tempat untuk menulis data. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
bigqueryDestination

object (BigQueryDestination)

Jika ditentukan, mengonfigurasi ekspor ke BigQuery.

Akhir kolom yang saling eksklusif.

BigQueryDestination

Konfigurasi untuk tujuan di BigQuery.

Representasi JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Kolom
table

string

Wajib. Referensi tabel tujuan BigQuery dalam format berikut: "projectId.dataset_id.table_id".

Jika resource yang dirujuk tidak ada, tabel baru akan dibuat. Hal ini berlaku jika parameter "append" dan "overwrite" juga salah.

Jika resource yang dirujuk ada dan memiliki skema yang kompatibel, salah satu parameter "overwrite" dan "append" harus benar, jika tidak, tugas akan gagal.

Jika resource yang dirujuk ada dan skema tidak kompatibel dengan yang ada, tugas juga akan gagal.

overwrite

boolean

Menentukan apakah data tabel harus ditimpa jika tabel sudah ada dan memiliki skema yang kompatibel.

Parameter overwrite dan append tidak dapat true secara bersamaan.

append

boolean

Menentukan apakah data tabel harus ditambahkan jika tabel sudah ada dan memiliki skema yang kompatibel.

Parameter overwrite dan append tidak dapat true secara bersamaan.