REST Resource: projects.datasets

리소스: 데이터 세트

데이터 세트 리소스를 나타냅니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "description": string,
  "versionId": string,
  "usage": [
    enum (Usage)
  ],
  "status": {
    object (Status)
  },
  "createTime": string,
  "updateTime": string,
  "versionCreateTime": string,
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
입력란
name

string

리소스 이름입니다. 형식: projects/{project}/datasets/{datasetId}

displayName

string

콘솔 UI에 표시되는 인간이 읽을 수 있는 이름입니다.

프로젝트 내에서 고유해야 합니다.

description

string

이 데이터 세트의 설명입니다.

versionId

string

데이터 세트의 버전 ID입니다.

usage[]

enum (Usage)

이 데이터 세트의 지정된 사용 사례입니다.

status

object (Status)

출력 전용입니다. 이 데이터 세트 버전의 상태입니다.

createTime

string (Timestamp format)

출력 전용입니다. 데이터 세트가 처음 생성된 시간입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 데이터 세트 메타데이터가 마지막으로 업데이트된 시간입니다.

versionCreateTime

string (Timestamp format)

출력 전용입니다. 이 버전이 생성된 시간입니다.

versionDescription

string

출력 전용입니다. 이 버전의 데이터 세트에 대한 설명입니다. 데이터 세트로 데이터를 가져올 때 제공됩니다.

통합 필드 data_source. 데이터 세트의 데이터 소스에 대한 세부정보입니다. data_source는 다음 중 하나여야 합니다.
localFileSource

object (LocalFileSource)

단일 업로드를 위한 데이터 세트의 로컬 파일 소스입니다.

gcsSource

object (GcsSource)

단일 업로드를 위한 데이터 세트의 Google Cloud Storage 파일 소스입니다.

사용량

용도는 데이터 처리 방법을 알리기 위해 데이터가 사용될 위치를 지정합니다.

열거형
USAGE_UNSPECIFIED 이 데이터 세트의 사용량이 설정되지 않았습니다.
USAGE_DATA_DRIVEN_STYLING 이 데이터 세트는 데이터 기반 스타일 지정에 사용됩니다.

LocalFileSource

로컬 파일인 경우 데이터 소스에 대한 세부정보입니다.

JSON 표현
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
입력란
filename

string

업로드된 파일의 이름입니다.

fileFormat

enum (FileFormat)

업로드되는 파일의 형식입니다.

FileFormat

업로드되는 파일의 형식입니다.

열거형
FILE_FORMAT_UNSPECIFIED 지정되지 않은 파일 형식입니다.
FILE_FORMAT_GEOJSON GeoJson 파일
FILE_FORMAT_KML KML 파일.
FILE_FORMAT_CSV CSV 파일로 다운로드할 수 있습니다.

GcsSource

Google Cloud Storage에 있는 데이터 소스에 대한 세부정보입니다.

JSON 표현
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
입력란
inputUri

string

소스 데이터 URI 예를 들면 다음과 같습니다. gs://my_bucket/my_object

fileFormat

enum (FileFormat)

Google Cloud Storage 객체의 파일 형식입니다. 주로 유효성 검사에 사용됩니다.

상태

데이터 세트의 상태입니다.

JSON 표현
{
  "state": enum (State),
  "errorMessage": string
}
입력란
state

enum (State)

상태에 대한 상태 enum입니다.

errorMessage

string

실패 이유를 나타내는 오류 메시지 데이터 세트가 실패 상태가 아닌 경우 비어 있습니다.

상태

데이터 세트의 상태 목록입니다.

열거형
STATE_UNSPECIFIED 이 데이터 세트의 상태가 설정되지 않았습니다.
STATE_IMPORTING 데이터 세트로 데이터를 가져오는 중입니다.
STATE_IMPORT_SUCCEEDED 데이터 세트로 데이터를 가져왔습니다.
STATE_IMPORT_FAILED 데이터 세트로 데이터를 가져올 수 없습니다.
STATE_DELETING 데이터 세트를 삭제하는 중입니다.
STATE_DELETION_FAILED 삭제 실패 상태입니다. 이 상태는 데이터 세트 삭제가 실패했음을 나타냅니다. 삭제를 다시 시도할 수 있습니다.
STATE_PROCESSING 데이터를 처리하는 중입니다.
STATE_PROCESSING_FAILED 처리 실패 상태입니다. 이 상태는 처리에 실패했으며 오류가 보고될 수 있음을 나타냅니다.
STATE_NEEDS_REVIEW 이 상태는 현재 사용되지 않습니다.
STATE_PUBLISHING 게시 상태입니다. 이 상태는 게시가 진행 중임을 나타냅니다.
STATE_PUBLISHING_FAILED 게시 실패 상태입니다. 이 상태는 게시에 실패했음을 나타냅니다. 게시를 다시 시도할 수 있습니다.
STATE_COMPLETED 완료된 상태입니다. 이 상태는 데이터 세트를 특정 용도로 사용할 수 있음을 나타냅니다.

방법

create

지정된 프로젝트의 새 데이터 세트를 만듭니다.

delete

지정된 데이터 세트를 삭제합니다.

get

데이터 세트를 가져옵니다.

list

지정된 프로젝트의 모든 데이터 세트를 나열합니다.

patch

데이터 세트의 메타데이터를 업데이트합니다.