Method: projects.table.export

Damit wird ein Batch-Prozess gestartet, bei dem eine Tabelle berechnet und das Ergebnis in eines von mehreren Zielen geschrieben wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
project

string

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

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource project erforderlich:

  • 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,

  // 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.
}
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, mit dem doppelte Anfragen erkannt werden. Wenn derselbe Nutzer mehrere Anfragen mit derselben nicht leeren requestId stellt, kann nur eine dieser Anfragen einen langwierigen Vorgang starten. requestId darf die Zeichen a–z, A–Z, 0–9 oder „-“ enthalten. requestId darf maximal 60 Zeichen lang sein.
maxErrorMeters

number

Der maximal zulässige Fehler in Metern bei der Transformation von Geometrie zwischen Koordinatensystemen. Wenn das Feld leer ist, beträgt der maximale Fehler standardmäßig 1 Meter.
maxVertices

integer

Maximale Anzahl der nicht zugeschnittenen Eckpunkte pro Geometrie. Geometrien mit mehr Eckpunkten werden in Stücke geschnitten, die kleiner als diese Größe sind.
workloadTag

string

Vom Nutzer bereitgestelltes Label zum Erfassen 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. Wenn kein Wert festgelegt ist, wird der Standardwert 100 verwendet.
Union-Feld export_options. Optionen, die angeben, wo und wie die Ergebnisse gespeichert werden sollen. Für export_options ist nur einer der folgenden Werte zulässig:
fileExportOptions

object (TableFileExportOptions)

Wenn angegeben, wird der Export als Datei konfiguriert.
assetExportOptions

object (TableAssetExportOptions)

Wenn angegeben, wird der Export als Earth Engine-Asset konfiguriert.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

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

object (BigQueryExportOptions)

Wenn angegeben, wird der Export tabellarischer Daten nach BigQuery konfiguriert.

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),

  // 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.
}
Felder
fileFormat

enum (TableFileFormat)

Das Dateiformat, in dem die Tabellen exportiert werden sollen.
Union-Feld destination. Speicherort, an den die Ergebnisse geschrieben werden sollen. Für destination ist nur einer der folgenden Werte zulässig:
driveDestination

object (DriveDestination)

Wenn angegeben, wird der Export in Google Drive konfiguriert.
cloudStorageDestination

object (CloudStorageDestination)

Wenn angegeben, wird der Export nach Google Cloud Storage konfiguriert.

TableAssetExportOptions

Optionen zum Speichern von Tabellen als Earth Engine-Assets.

JSON-Darstellung 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
Felder
Union-Feld destination. Speicherort, an den die Ergebnisse geschrieben werden sollen. Für destination ist nur einer der folgenden Werte zulässig:
earthEngineDestination

object (EarthEngineDestination)

Wenn angegeben, wird der Export in Earth Engine konfiguriert.

FeatureViewAssetExportOptions

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

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

object (FeatureViewIngestionTimeParameters)

Die Parameter für die Datenaufnahmezeit von Feature-Datenansichten. Diese Parameter müssen bei der Datenaufnahme angegeben werden und können nicht „on the fly“ aktualisiert werden.
Union-Feld destination. Speicherort, an den die Ergebnisse geschrieben werden sollen. Für destination ist nur einer der folgenden Werte zulässig:
featureViewDestination

object (FeatureViewDestination)

Wenn angegeben, wird der Export in FeatureViews konfiguriert.

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 anhand der ID einen Kartennamen.
assetVersion

integer

Die zu erstellende Asset-Version der Feature-Anzeige. Wird für Aliasse von Versionen mit Assets verwendet. Wenn nicht festgelegt, wird „0“ verwendet.

BigQueryExportOptions

Optionen zum Exportieren tabellarischer Daten nach BigQuery.

JSON-Darstellung 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
Felder
Union-Feld destination. Wo die Daten geschrieben werden sollen. Für destination ist nur einer der folgenden Werte zulässig:
bigqueryDestination

object (BigQueryDestination)

Wenn angegeben, wird der Export nach BigQuery konfiguriert.

BigQueryDestination

Konfiguration für ein Ziel in BigQuery.

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

string

Erforderlich. Die BigQuery-Zieltabellenreferenz 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 auf „false“ gesetzt 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 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.