Method: projects.table.export

Запускает пакетный процесс, который вычисляет таблицу и записывает результат в одно из нескольких мест назначения.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
project

string

Идентификатор проекта или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для данного запроса. Формат: projects/{project-id} .

Для авторизации требуются следующие разрешения IAM для указанного project ресурсов:

  • earthengine.exports.create

Текст запроса

Тело запроса содержит данные следующей структуры:

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.
}
Поля
expression

object ( Expression )

Выражение, результат вычисления которого соответствует таблице для расчета и экспорта.

description

string

Удобочитаемое название задачи.

selectors[]

string

Четко указанный список столбцов, которые следует включить в результат.

requestId

string

Уникальная строка, используемая для обнаружения дублирующихся запросов. Если один и тот же пользователь отправляет более одного запроса с одинаковым непустым requestId , только один из этих запросов может успешно запустить длительную операцию. requestId может содержать символы от a до z, от A до Z, от 0 до 9 или дефис. Длина requestId не должна превышать 60 символов.

maxErrorMeters

number

Максимально допустимая погрешность в метрах при преобразовании геометрии между системами координат. Если поле пустое, по умолчанию максимальная погрешность составляет 1 метр.

maxVertices

integer

Максимальное количество неразрезанных вершин на один геометрический объект; объекты с большим количеством вершин будут разрезаны на части меньшего размера.

workloadTag

string

Пользователь предоставил метку для отслеживания этого вычисления.

priority

integer

Необязательный параметр. Приоритет задачи экспорта в рамках проекта. Задачи с более высоким приоритетом планируются раньше. Должно быть целым числом от 0 до 9999. По умолчанию — 100, если не задано.

Параметры, описывающие, где и как хранить результаты. Ниже приведен список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
fileExportOptions

object ( TableFileExportOptions )

Если указано, настраивает экспорт в файл.

assetExportOptions

object ( TableAssetExportOptions )

Если указано, настраивает экспорт как ресурс Earth Engine.

featureViewExportOptions

object ( FeatureViewAssetExportOptions )

Если указано, настраивает экспорт в виде карты FeatureView.

bigqueryExportOptions

object ( BigQueryExportOptions )

При необходимости настраивает экспорт табличных данных в BigQuery.

Конец взаимоисключающих областей.

Ответный текст

В случае успеха тело ответа содержит экземпляр Operation .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

TableFileExportOptions

Параметры экспорта таблиц в файлы вне Earth Engine.

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.
}
Поля
fileFormat

enum ( TableFileFormat )

Формат файла, в котором следует экспортировать таблицу (таблицы).

Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
driveDestination

object ( DriveDestination )

Если указано, настраивает экспорт в Google Диск.

cloudStorageDestination

object ( CloudStorageDestination )

Если указано, настраивает экспорт в Google Cloud Storage.

Конец взаимоисключающих областей.

TableAssetExportOptions

Параметры сохранения таблиц в качестве ресурсов Earth Engine.

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.
}
Поля
Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
earthEngineDestination

object ( EarthEngineDestination )

Если указано, настраивает экспорт в Earth Engine.

Конец взаимоисключающих областей.

FeatureViewAssetExportOptions

Варианты сохранения таблиц или коллекций объектов в виде карт FeatureView.

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.
}
Поля
ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

Параметры времени загрузки FeatureView. Эти параметры должны быть указаны во время загрузки и не могут быть изменены на лету.

Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
featureViewDestination

object ( FeatureViewDestination )

Если указано, настраивает экспорт в FeatureViews.

Конец взаимоисключающих областей.

FeatureViewDestination

Настройки для целевого объекта Earth Engine FeatureView.

JSON-представление
{
  "name": string,
  "assetVersion": integer
}
Поля
name

string

Обязательно. Идентификатор ресурса FeatureView. Сервер генерирует имя карты на основе этого идентификатора.

assetVersion

integer

Версия ресурса FeatureView, которую необходимо создать. Используется для сопоставления версий с ресурсами. Если не задано, будет использоваться значение 0.

BigQueryExportOptions

Варианты экспорта табличных данных в BigQuery.

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.
}
Поля
Куда записывать данные. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
bigqueryDestination

object ( BigQueryDestination )

Если указано, настраивает экспорт в BigQuery.

Конец взаимоисключающих областей.

BigQueryDestination

Настройка целевого объекта в BigQuery.

JSON-представление
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Поля
table

string

Обязательно. Ссылка на целевую таблицу BigQuery в следующем формате: "projectId.dataset_id.table_id".

Если указанный ресурс не существует, будет создана новая таблица. Это относится и к случаю, если параметры "append" и "overwrite" имеют значение false.

Если указанный ресурс существует и имеет совместимую схему, один из параметров "overwrite" или "append" должен быть равен true, в противном случае задача завершится с ошибкой.

Если указанный ресурс существует, но схема несовместима с существующей, задача также завершится с ошибкой.

overwrite

boolean

Указывает, следует ли перезаписывать данные таблицы, если таблица уже существует и имеет совместимую схему.

Параметры overwrite и append не могут одновременно иметь true .

append

boolean

Указывает, следует ли добавлять данные таблицы, если таблица уже существует и имеет совместимую схему.

Параметры overwrite и append не могут одновременно иметь true .

,

Запускает пакетный процесс, который вычисляет таблицу и записывает результат в одно из нескольких мест назначения.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
project

string

Идентификатор проекта или номер проекта Google Cloud Platform, который следует рассматривать как потребителя услуги для данного запроса. Формат: projects/{project-id} .

Для авторизации требуются следующие разрешения IAM для указанного project ресурсов:

  • earthengine.exports.create

Текст запроса

Тело запроса содержит данные следующей структуры:

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.
}
Поля
expression

object ( Expression )

Выражение, результат вычисления которого соответствует таблице для расчета и экспорта.

description

string

Удобочитаемое название задачи.

selectors[]

string

Четко указанный список столбцов, которые следует включить в результат.

requestId

string

Уникальная строка, используемая для обнаружения дублирующихся запросов. Если один и тот же пользователь отправляет более одного запроса с одинаковым непустым requestId , только один из этих запросов может успешно запустить длительную операцию. requestId может содержать символы от a до z, от A до Z, от 0 до 9 или дефис. Длина requestId не должна превышать 60 символов.

maxErrorMeters

number

Максимально допустимая погрешность в метрах при преобразовании геометрии между системами координат. Если поле пустое, по умолчанию максимальная погрешность составляет 1 метр.

maxVertices

integer

Максимальное количество неразрезанных вершин на один геометрический объект; объекты с большим количеством вершин будут разрезаны на части меньшего размера.

workloadTag

string

Пользователь предоставил метку для отслеживания этого вычисления.

priority

integer

Необязательный параметр. Приоритет задачи экспорта в рамках проекта. Задачи с более высоким приоритетом планируются раньше. Должно быть целым числом от 0 до 9999. По умолчанию — 100, если не задано.

Параметры, описывающие, где и как хранить результаты. Ниже приведен список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
fileExportOptions

object ( TableFileExportOptions )

Если указано, настраивает экспорт в файл.

assetExportOptions

object ( TableAssetExportOptions )

Если указано, настраивает экспорт как ресурс Earth Engine.

featureViewExportOptions

object ( FeatureViewAssetExportOptions )

Если указано, настраивает экспорт в виде карты FeatureView.

bigqueryExportOptions

object ( BigQueryExportOptions )

При необходимости настраивает экспорт табличных данных в BigQuery.

Конец взаимоисключающих областей.

Ответный текст

В случае успеха тело ответа содержит экземпляр Operation .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

TableFileExportOptions

Параметры экспорта таблиц в файлы вне Earth Engine.

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.
}
Поля
fileFormat

enum ( TableFileFormat )

Формат файла, в котором следует экспортировать таблицу (таблицы).

Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
driveDestination

object ( DriveDestination )

Если указано, настраивает экспорт в Google Диск.

cloudStorageDestination

object ( CloudStorageDestination )

Если указано, настраивает экспорт в Google Cloud Storage.

Конец взаимоисключающих областей.

TableAssetExportOptions

Параметры сохранения таблиц в качестве ресурсов Earth Engine.

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.
}
Поля
Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
earthEngineDestination

object ( EarthEngineDestination )

Если указано, настраивает экспорт в Earth Engine.

Конец взаимоисключающих областей.

FeatureViewAssetExportOptions

Варианты сохранения таблиц или коллекций объектов в виде карт FeatureView.

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.
}
Поля
ingestionTimeParameters

object ( FeatureViewIngestionTimeParameters )

Параметры времени загрузки FeatureView. Эти параметры должны быть указаны во время загрузки и не могут быть изменены на лету.

Куда записывать результаты. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
featureViewDestination

object ( FeatureViewDestination )

Если указано, настраивает экспорт в FeatureViews.

Конец взаимоисключающих областей.

FeatureViewDestination

Настройки для целевого объекта Earth Engine FeatureView.

JSON-представление
{
  "name": string,
  "assetVersion": integer
}
Поля
name

string

Обязательно. Идентификатор ресурса FeatureView. Сервер генерирует имя карты на основе этого идентификатора.

assetVersion

integer

Версия ресурса FeatureView, которую необходимо создать. Используется для сопоставления версий с ресурсами. Если не задано, будет использоваться значение 0.

BigQueryExportOptions

Варианты экспорта табличных данных в BigQuery.

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.
}
Поля
Куда записывать данные. Ниже приведён список взаимоисключающих полей. В ответе будет установлено не более одного из полей:
bigqueryDestination

object ( BigQueryDestination )

Если указано, настраивает экспорт в BigQuery.

Конец взаимоисключающих областей.

BigQueryDestination

Настройка целевого объекта в BigQuery.

JSON-представление
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
Поля
table

string

Обязательно. Ссылка на целевую таблицу BigQuery в следующем формате: "projectId.dataset_id.table_id".

Если указанный ресурс не существует, будет создана новая таблица. Это относится и к случаю, если параметры "append" и "overwrite" имеют значение false.

Если указанный ресурс существует и имеет совместимую схему, один из параметров "overwrite" или "append" должен быть равен true, в противном случае задача завершится с ошибкой.

Если указанный ресурс существует, но схема несовместима с существующей, задача также завершится с ошибкой.

overwrite

boolean

Указывает, следует ли перезаписывать данные таблицы, если таблица уже существует и имеет совместимую схему.

Параметры overwrite и append не могут одновременно иметь true .

append

boolean

Указывает, следует ли добавлять данные таблицы, если таблица уже существует и имеет совместимую схему.

Параметры overwrite и append не могут одновременно иметь true .