Method: projects.table.export

Startet einen Batchprozess, mit dem eine Tabelle berechnet und das Ergebnis in eines von mehreren Zielen geschrieben wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
project

string

Die Projekt-ID oder Projektnummer des Google Cloud Platform-Projekts, das für diese Anfrage als Dienstnutzer behandelt werden soll. Das Format ist projects/{project-id}.

Die Autorisierung erfordert folgende IAM-Berechtigung für die angegebene Ressource project:

  • earthengine.exports.create

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "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.
}
Felder
expression

object (Expression)

Ein Ausdruck, der die zu berechnende und zu exportierende Tabelle ergibt.

description

string

Ein für Menschen lesbarer Name der Aufgabe.

selectors[]

string

Eine explizite Liste der Spalten, die im Ergebnis enthalten sein sollen.

requestId

string

Ein eindeutiger String zum Erkennen doppelter Anfragen. Wenn derselbe Nutzer mit demselben nicht leeren requestId mehrere Anfragen stellt, kann nur bei einer dieser Anfragen ein Vorgang mit langer Ausführungszeit erfolgreich gestartet werden. requestId darf die Zeichen a..z, A..Z, 0–9 oder „-“ enthalten und requestId maximal 60 Zeichen lang sein.

maxErrorMeters

number

Der maximal zulässige Fehler in Metern beim Transformieren von Geometrie zwischen Koordinatensystemen. Wenn leer, beträgt der maximale Fehler standardmäßig 1 Meter.

maxVertices

integer

Maximale Anzahl von ungeschnittenen Knotenpunkten pro Geometrie. Geometrien mit mehr Knotenpunkten werden in kleinere Teile zerlegt.

workloadTag

string

Vom Nutzer bereitgestelltes Label zur Nachverfolgung dieser Berechnung.

priority

integer

Optional. Die Priorität der Exportaufgabe innerhalb des Projekts. Aufgaben mit höherer Priorität werden früher geplant. Muss eine Ganzzahl zwischen 0 und 9999 sein. Wird kein Wert festgelegt, beträgt die Standardeinstellung 100.

Optionen, die beschreiben, wo und wie die Ergebnisse gespeichert werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
fileExportOptions

object (TableFileExportOptions)

Konfiguriert den Export als Datei.

assetExportOptions

object (TableAssetExportOptions)

Konfiguriert den Export als Earth Engine-Asset, sofern angegeben.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Wenn angegeben, wird der Export als FeatureView-Karte konfiguriert.

bigqueryExportOptions

object (BigQueryExportOptions)

Konfiguriert, sofern angegeben, den Export von tabellarischen Daten nach BigQuery.

Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

TableFileExportOptions

Optionen zum Exportieren von Tabellen als Dateien außerhalb von Earth Engine.

JSON-Darstellung
{
  "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.
}
Felder
fileFormat

enum (TableFileFormat)

Das Dateiformat, in dem die Tabelle(n) exportiert werden sollen.

Wo die Ergebnisse geschrieben werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
driveDestination

object (DriveDestination)

Konfiguriert den Export nach Google Drive, falls angegeben.

cloudStorageDestination

object (CloudStorageDestination)

Konfiguriert den Export nach Google Cloud Storage, falls angegeben.

Ende der sich gegenseitig ausschließenden Felder.

TableAssetExportOptions

Optionen zum Speichern von Tabellen als Earth Engine-Assets.

JSON-Darstellung
{

  // 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.
}
Felder
Wo die Ergebnisse geschrieben werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
earthEngineDestination

object (EarthEngineDestination)

Konfiguriert den Export nach Earth Engine, falls angegeben.

Ende der sich gegenseitig ausschließenden Felder.

FeatureViewAssetExportOptions

Optionen zum Speichern von Tabellen oder FeatureCollections als FeatureView-Karten.

JSON-Darstellung
{
  "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.
}
Felder
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Die Parameter für die Aufnahmezeit von FeatureView. Diese Parameter müssen bei der Aufnahme angegeben werden und können nicht spontan aktualisiert werden.

Wo die Ergebnisse geschrieben werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
featureViewDestination

object (FeatureViewDestination)

Konfiguriert den Export in FeatureViews, falls angegeben.

Ende der sich gegenseitig ausschließenden Felder.

FeatureViewDestination

Konfiguration für ein Earth Engine FeatureView-Ziel.

JSON-Darstellung
{
  "name": string,
  "assetVersion": integer
}
Felder
name

string

Erforderlich. Die Asset-ID der FeatureView. Der Server generiert einen Kartennamen aus der ID.

assetVersion

integer

Die Version des FeatureView-Assets, die erstellt werden soll. Wird zum Aliasen von Versionen mit Assets verwendet. Wenn nicht festgelegt, wird 0 verwendet.

BigQueryExportOptions

Optionen für den Export von Tabellendaten nach BigQuery.

JSON-Darstellung
{

  // 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.
}
Felder
Wo die Daten geschrieben werden sollen. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
bigqueryDestination

object (BigQueryDestination)

Wenn angegeben, wird der Export nach BigQuery konfiguriert.

Ende der sich gegenseitig ausschließenden Felder.

BigQueryDestination

Konfiguration für ein Ziel in BigQuery.

JSON-Darstellung
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Felder
table

string

Erforderlich. Die BigQuery-Zieltabelle im folgenden Format: „projectId.dataset_id.table_id“.

Wenn die referenzierte Ressource nicht vorhanden ist, wird eine neue Tabelle erstellt. Dies gilt auch, wenn die Parameter „append“ und „overwrite“ beide falsch sind.

Wenn die referenzierte Ressource vorhanden ist und ein kompatibles Schema hat, muss einer der Parameter „overwrite“ und „append“ auf „true“ gesetzt sein. Andernfalls schlägt die Aufgabe fehl.

Wenn die referenzierte Ressource vorhanden ist und das Schema nicht mit dem vorhandenen Schema kompatibel ist, schlägt die Aufgabe ebenfalls fehl.

overwrite

boolean

Gibt an, ob die Tabellendaten überschrieben werden sollen, wenn die Tabelle bereits vorhanden ist und ein kompatibles Schema hat.

Die Parameter overwrite und append können nicht gleichzeitig true sein.

append

boolean

Gibt an, ob die Tabellendaten angehängt werden sollen, wenn die Tabelle bereits vorhanden ist und ein kompatibles Schema hat.

Die Parameter overwrite und append können nicht gleichzeitig true sein.