Method: projects.table.export

Uruchamia proces zbiorczy, który oblicza tabelę i zapisuje wynik w jednym z kilku miejsc docelowych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
project

string

Identyfikator lub numer projektu Google Cloud Platform, który powinien być traktowany jako konsument usługi w przypadku tej prośby. Format to projects/{project-id}.

Autoryzacja wymaga tych uprawnień IAM w przypadku określonego zasobu: project

  • earthengine.exports.create

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
expression

object (Expression)

Wyrażenie, które zwraca tabelę do obliczenia i wyeksportowania.

description

string

Zrozumiała dla człowieka nazwa zadania.

selectors[]

string

Wyraźna lista kolumn do uwzględnienia w wyniku.

requestId

string

Unikalny ciąg znaków służący do wykrywania zduplikowanych żądań. Jeśli ten sam użytkownik wyśle więcej niż 1 żądanie z tą samą niepustą wartością requestId, tylko jedno z tych żądań może rozpocząć długotrwałą operację. requestId może zawierać znaki a–z, A–Z, 0–9 lub „–”. requestId może mieć maksymalnie 60 znaków.

maxErrorMeters

number

Maksymalny dopuszczalny błąd w metrach podczas przekształcania geometrii między układami współrzędnych. Jeśli to pole jest puste, domyślna maksymalna wartość błędu to 1 metr.

maxVertices

integer

Maksymalna liczba nieprzeciętych wierzchołków na geometrię. Geometrie z większą liczbą wierzchołków podzieli się na kawałki mniejsze niż ta wartość.

workloadTag

string

Etykieta dostarczona przez użytkownika do śledzenia tego obliczenia.

priority

integer

Opcjonalnie: Priorytet zadania eksportowania w projekcie. Zadania o wyższym priorytecie są planowane wcześniej. Wartość musi być liczbą całkowitą z zakresu od 0 do 9999. Jeśli nie zostanie ustawiony, domyślna wartość to 100.

Pole unii export_options. Opcje określające, gdzie i jak mają być przechowywane wyniki. export_options może być tylko jednym z tych elementów:
fileExportOptions

object (TableFileExportOptions)

Jeśli jest określony, konfiguruje eksport jako plik.

assetExportOptions

object (TableAssetExportOptions)

Jeśli jest określony, skonfiguruj eksport jako zasób Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Jeśli jest określony, konfiguruje eksport jako mapę FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Jeśli jest określony, konfiguruje eksport danych tabelarycznych do BigQuery.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.

TableFileExportOptions

Opcje eksportowania tabel jako plików poza Earth Engine.

Zapis 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.
}
Pola
fileFormat

enum (TableFileFormat)

Format pliku, w którym mają zostać wyeksportowane tabele.

Pole unii destination. Gdzie zapisać wyniki. destination może być tylko jednym z tych elementów:
driveDestination

object (DriveDestination)

Jeśli jest określony, konfiguruje eksport na Dysk Google.

cloudStorageDestination

object (CloudStorageDestination)

Jeśli jest podany, konfiguruje eksport do Google Cloud Storage.

TableAssetExportOptions

Opcje zapisywania tabel jako zasobów Earth Engine.

Zapis JSON
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Pola
Pole unii destination. Gdzie zapisać wyniki. destination może być tylko jednym z tych elementów:
earthEngineDestination

object (EarthEngineDestination)

Jeśli jest podany, konfiguruje eksport do Earth Engine.

FeatureViewAssetExportOptions

Opcje zapisywania tabel lub kolekcji funkcji jako mapy widoku funkcji.

Zapis 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.
}
Pola
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Parametry czasu przetwarzania danych w usłudze FeatureView. Te parametry muszą być określone w momencie przetwarzania i nie można ich aktualizować w locie.

Pole unii destination. Gdzie zapisać wyniki. destination może być tylko jednym z tych elementów:
featureViewDestination

object (FeatureViewDestination)

Jeśli jest określony, konfiguruje eksport do FeatureView.

FeatureViewDestination

Konfiguracja miejsca docelowego FeatureView w Earth Engine.

Zapis JSON
{
  "name": string,
  "assetVersion": integer
}
Pola
name

string

Wymagany. Identyfikator zasobu FeatureView. Serwer generuje nazwę mapy na podstawie identyfikatora.

assetVersion

integer

Wersja zasobu FeatureView do utworzenia. Służy do tworzenia aliasów wersji zasobów. Jeśli nie zostanie ustawiona, użyta zostanie wartość 0.

BigQueryExportOptions

Opcje eksportowania danych tabelarycznych do BigQuery

Zapis JSON
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Pola
Pole unii destination. Miejsce zapisu danych. destination może być tylko jednym z tych elementów:
bigqueryDestination

object (BigQueryDestination)

Jeśli jest określony, konfiguruje eksport do BigQuery.

BigQueryDestination

Konfiguracja miejsca docelowego w BigQuery.

Zapis JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Pola
table

string

Wymagany. odwołanie do tabeli docelowej BigQuery w formacie „identyfikator_projektu.identyfikator_zbioru_danych.identyfikator_tabeli”.

Jeśli zasób, do którego się odwołuje, nie istnieje, zostanie utworzona nowa tabela. Dotyczy to sytuacji, gdy parametry „append” i „overwrite” mają wartość „fałsz”.

Jeśli odwołujący się zasób istnieje i ma zgodny schemat, jeden z parametrów „overwrite” lub „append” musi mieć wartość Prawda. W przeciwnym razie zadanie zakończy się niepowodzeniem.

Jeśli zasób, na który się powołujesz, istnieje, a schemat jest niezgodny z dotychczasowym, zadanie również się nie powiedzie.

overwrite

boolean

Określa, czy dane tabeli mają być zastąpione, jeśli tabela już istnieje i ma zgodny schemat.

Parametry overwrite i append nie mogą być jednocześnie true.

append

boolean

Określa, czy dane tabeli mają być dołączane, jeśli tabela już istnieje i ma zgodny schemat.

Parametry overwrite i append nie mogą być jednocześnie true.