Method: projects.table.export

Uruchamia proces wsadowy, 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 tego żądania. Format to projects/{project-id}.

Autoryzacja wymaga tych uprawnień IAM w odniesieniu do 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,

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

object (Expression)

Wyrażenie, które daje w wyniku tabelę do obliczenia i wyeksportowania.

description

string

Zrozumiała dla człowieka nazwa zadania.

selectors[]

string

Jawna lista kolumn do uwzględnienia w wyniku.

requestId

string

Unikalny ciąg znaków używany do wykrywania zduplikowanych żądań. Jeśli ten sam użytkownik wyśle więcej niż 1 żądanie z tym samym niepustym parametrem requestId, tylko jedno z tych żądań może spowodować rozpoczęcie długo trwającej operacji. 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ślny maksymalny błąd wynosi 1 metr.

maxVertices

integer

Maksymalna liczba nieprzyciętych wierzchołków w geometrii. Geometrie z większą liczbą wierzchołków zostaną podzielone na mniejsze części.

workloadTag

string

Etykieta podana przez użytkownika do śledzenia tych obliczeń.

priority

integer

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

Opcje określające, gdzie i jak przechowywać wyniki. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
fileExportOptions

object (TableFileExportOptions)

Jeśli ta opcja jest określona, konfiguruje eksportowanie jako plik.

assetExportOptions

object (TableAssetExportOptions)

Jeśli ta opcja jest określona, konfiguruje eksport jako zasób Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Jeśli podano, konfiguruje eksport jako mapę FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Jeśli jest to określone, konfiguruje eksportowanie danych tabelarycznych do BigQuery.

Koniec pól wykluczających się nawzajem.

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 sekcji OAuth 2.0 Overview.

TableFileExportOptions

Opcje eksportowania tabel jako plików poza Earth Engine.

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

enum (TableFileFormat)

Format pliku, do którego chcesz wyeksportować tabele.

Miejsce, w którym mają być zapisane wyniki. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
driveDestination

object (DriveDestination)

Jeśli ta opcja jest określona, konfiguruje eksportowanie na Dysk Google.

cloudStorageDestination

object (CloudStorageDestination)

Jeśli ta opcja jest określona, konfiguruje eksport do Google Cloud Storage.

Koniec pól wykluczających się nawzajem.

TableAssetExportOptions

Opcje zapisywania tabel jako zasobów Earth Engine.

Zapis 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.
}
Pola
Miejsce, w którym mają być zapisane wyniki. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
earthEngineDestination

object (EarthEngineDestination)

Jeśli jest określony, konfiguruje eksport do Earth Engine.

Koniec pól wykluczających się nawzajem.

FeatureViewAssetExportOptions

Opcje zapisywania tabel lub obiektów FeatureCollection jako map FeatureView.

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

object (FeatureViewIngestionTimeParameters)

Parametry czasu przesyłania danych do widoku cech. Te parametry muszą być określone w momencie przesyłania danych i nie można ich aktualizować na bieżąco.

Miejsce, w którym mają być zapisane wyniki. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
featureViewDestination

object (FeatureViewDestination)

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

Koniec pól wykluczających się nawzajem.

FeatureViewDestination

Konfiguracja miejsca docelowego FeatureView w Earth Engine.

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

string

Wymagane. 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 z zasobami. Jeśli nie zostanie ustawiona, użyta zostanie wartość 0.

BigQueryExportOptions

Opcje eksportowania danych tabelarycznych do BigQuery.

Zapis 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.
}
Pola
miejsce, w którym mają być zapisane dane. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
bigqueryDestination

object (BigQueryDestination)

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

Koniec pól wykluczających się nawzajem.

BigQueryDestination

Konfiguracja miejsca docelowego w BigQuery.

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

string

Wymagane. Odwołanie do tabeli docelowej BigQuery w formacie „projectId.dataset_id.table_id”.

Jeśli odwoływany zasób nie istnieje, zostanie utworzona nowa tabela. Dotyczy to również sytuacji, gdy parametry „append” i „overwrite” mają wartość false.

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

Jeśli przywoływany zasób istnieje, a schemat nie jest zgodny z istniejącym, zadanie również zakończy się niepowodzeniem.

overwrite

boolean

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

Parametry overwriteappend 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 overwriteappend nie mogą być jednocześnie true.