Method: projects.table.export

Lance un processus par lot qui calcule une table et écrit le résultat dans l'une des nombreuses destinations.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
project

string

ID ou numéro du projet Google Cloud Platform qui doit être considéré comme le client du service pour cette requête. Le format est le suivant : projects/{project-id}.

L'autorisation IAM suivante est requise pour la ressource project indiquée :

  • earthengine.exports.create

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation 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.
}
Champs
expression

object (Expression)

Expression qui renvoie à la table à calculer et à exporter.

description

string

Nom de la tâche lisible par l'utilisateur.

selectors[]

string

Liste explicite des colonnes à inclure dans le résultat.

requestId

string

Chaîne unique utilisée pour détecter les requêtes dupliquées. Si le même utilisateur effectue plusieurs requêtes avec le même requestId non vide, une seule de ces requêtes peut démarrer une opération de longue durée. requestId peut contenir les caractères a..z, A..Z, 0-9 ou "-". requestId ne doit pas dépasser 60 caractères.

maxErrorMeters

number

Erreur maximale autorisée en mètres lors de la transformation de la géométrie entre les systèmes de coordonnées. Si ce champ est vide, l'erreur maximale est de 1 mètre par défaut.

maxVertices

integer

Nombre maximal de sommets non coupés par géométrie. Les géométries comportant plus de sommets seront divisées en éléments plus petits que cette taille.

workloadTag

string

Libellé fourni par l'utilisateur pour suivre ce calcul.

priority

integer

Facultatif. Priorité de la tâche d'exportation dans le projet. Les tâches à priorité élevée sont planifiées plus tôt. Veuillez saisir un nombre entier compris entre 0 et 9 999. Si cette clause n'est pas définie, la valeur par défaut est 100.

Options décrivant où et comment stocker les résultats. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
fileExportOptions

object (TableFileExportOptions)

Si spécifié, configure l'exportation en tant que fichier.

assetExportOptions

object (TableAssetExportOptions)

Si spécifié, configure l'exportation en tant qu'élément Earth Engine.

featureViewExportOptions

object (FeatureViewAssetExportOptions)

Si cette option est spécifiée, elle configure l'exportation en tant que mappage FeatureView.

bigqueryExportOptions

object (BigQueryExportOptions)

Si spécifié, configure l'exportation des données tabulaires vers BigQuery.

Fin des champs qui s'excluent mutuellement.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la OAuth 2.0 Overview.

TableFileExportOptions

Options permettant d'exporter des tableaux sous forme de fichiers en dehors d'Earth Engine.

Représentation 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.
}
Champs
fileFormat

enum (TableFileFormat)

Format de fichier dans lequel exporter les tableaux.

Où écrire les résultats. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
driveDestination

object (DriveDestination)

Si spécifié, configure l'exportation vers Google Drive.

cloudStorageDestination

object (CloudStorageDestination)

Si spécifié, configure l'exportation vers Google Cloud Storage.

Fin des champs qui s'excluent mutuellement.

TableAssetExportOptions

Options permettant d'enregistrer des tables en tant qu'éléments Earth Engine.

Représentation 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.
}
Champs
Où écrire les résultats. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
earthEngineDestination

object (EarthEngineDestination)

Si cette option est spécifiée, elle configure l'exportation vers Earth Engine.

Fin des champs qui s'excluent mutuellement.

FeatureViewAssetExportOptions

Options permettant d'enregistrer des tableaux ou des FeatureCollections en tant que cartes FeatureView.

Représentation 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.
}
Champs
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

Paramètres de durée d'ingestion de FeatureView. Ces paramètres doivent être spécifiés au moment de l'ingestion et ne peuvent pas être mis à jour à la volée.

Où écrire les résultats. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
featureViewDestination

object (FeatureViewDestination)

Si spécifié, configure l'exportation vers FeatureViews.

Fin des champs qui s'excluent mutuellement.

FeatureViewDestination

Configuration d'une destination FeatureView Earth Engine.

Représentation JSON
{
  "name": string,
  "assetVersion": integer
}
Champs
name

string

Obligatoire. ID de l'élément FeatureView. Le serveur génère un nom de carte à partir de l'ID.

assetVersion

integer

Version de l'asset FeatureView à créer. Utilisé pour associer des alias de versions à des composants. Si ce paramètre n'est pas défini, la valeur 0 est utilisée.

BigQueryExportOptions

Options d'exportation de données tabulaires vers BigQuery.

Représentation 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.
}
Champs
Où écrire les données. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
bigqueryDestination

object (BigQueryDestination)

Si elle est spécifiée, elle configure l'exportation vers BigQuery.

Fin des champs qui s'excluent mutuellement.

BigQueryDestination

Configuration d'une destination dans BigQuery.

Représentation JSON
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Champs
table

string

Obligatoire. Référence à la table de destination BigQuery au format suivant : "projectId.dataset_id.table_id".

Si la ressource référencée n'existe pas, une table est créée. Cela s'applique également si les paramètres "append" et "overwrite" sont tous les deux définis sur "false".

Si la ressource référencée existe et possède un schéma compatible, l'un des paramètres "overwrite" et "append" doit être défini sur "true". Sinon, la tâche échouera.

Si la ressource référencée existe et que le schéma n'est pas compatible avec celui existant, la tâche échouera également.

overwrite

boolean

Indique si les données de la table doivent être écrasées si la table existe déjà et possède un schéma compatible.

Les paramètres overwrite et append ne peuvent pas être true en même temps.

append

boolean

Indique si les données de la table doivent être ajoutées si la table existe déjà et possède un schéma compatible.

Les paramètres overwrite et append ne peuvent pas être true en même temps.