Method: projects.table.export

테이블을 계산하고 결과를 여러 대상 중 하나에 쓰는 일괄 처리 프로세스를 시작합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
project

string

이 요청의 서비스 소비자로 처리되어야 하는 Google Cloud Platform 프로젝트의 프로젝트 ID 또는 프로젝트 번호입니다. 형식: projects/{project-id}

승인을 처리하려면 지정된 리소스 project에 대해 다음과 같은 IAM 권한이 필요합니다.

  • 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 Drive로 내보내기를 구성합니다.
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

표 또는 FeatureCollection을 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 애셋 ID입니다. 서버는 ID에서 지도 이름을 생성합니다.
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일 수 없습니다.