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,

  // 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.
}
필드
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입니다.
통합 필드 export_options. 결과를 저장하는 위치와 방법을 설명하는 옵션입니다. export_options은 다음 중 하나여야 합니다.
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),

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

enum (TableFileFormat)

테이블을 내보낼 파일 형식입니다.
통합 필드 destination. 결과를 작성할 위치입니다. destination은 다음 중 하나여야 합니다.
driveDestination

object (DriveDestination)

지정된 경우 Google Drive로 내보내기를 구성합니다.
cloudStorageDestination

object (CloudStorageDestination)

지정된 경우 Google Cloud Storage로 내보내기를 구성합니다.

TableAssetExportOptions

테이블을 Earth Engine 애셋으로 저장하는 옵션입니다.

JSON 표현 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
필드
통합 필드 destination. 결과를 작성할 위치입니다. destination은 다음 중 하나여야 합니다.
earthEngineDestination

object (EarthEngineDestination)

지정된 경우 Earth Engine으로 내보내기를 구성합니다.

FeatureViewAssetExportOptions

표 또는 FeatureCollection을 FeatureView 지도로 저장하는 옵션입니다.

JSON 표현 
{
  "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.
}
필드
ingestionTimeParameters

object (FeatureViewIngestionTimeParameters)

FeatureView 처리 시간 매개변수 이러한 매개변수는 처리 시 지정해야 하며 실시간으로 업데이트할 수 없습니다.
통합 필드 destination. 결과를 작성할 위치입니다. destination은 다음 중 하나여야 합니다.
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 표현 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
필드
통합 필드 destination. 데이터를 쓸 위치입니다. destination은 다음 중 하나여야 합니다.
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일 수 없습니다.