REST Resource: projects.datasets

Referensi: Set data

Representasi set data platform peta.

Representasi 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.
}
Kolom
name

string

Nama resource, project/{project}/set data/{dataset_id}

displayName

string

Nama yang dapat dibaca manusia, ditampilkan di UI konsol.

description

string

Deskripsi set data ini.

versionId

string

ID versi set data.

usage[]

enum (Usage)

Kasus penggunaan yang ditentukan untuk set data ini.

status

object (Status)

Hanya output. Status versi set data ini.

createTime

string (Timestamp format)

Hanya output. Waktu saat set data pertama kali dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Waktu saat metadata set data terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

versionCreateTime

string (Timestamp format)

Hanya output. Waktu saat versi set data ini dibuat. (Hal ini terjadi saat mengimpor data ke {i>dataset<i})

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

versionDescription

string

Hanya output. Deskripsi untuk versi set data ini. ID ini disediakan saat mengimpor data ke set data.

Kolom union data_source. Detail tentang sumber data untuk set data. data_source hanya dapat berupa salah satu dari berikut:
localFileSource

object (LocalFileSource)

Sumber file lokal untuk set data untuk satu upload.

gcsSource

object (GcsSource)

Sumber file Google Cloud Storage untuk set data untuk satu upload.

Penggunaan

Penggunaan menentukan tempat data akan digunakan untuk menginformasikan cara memproses data.

Enum
USAGE_UNSPECIFIED Penggunaan set data ini belum ditetapkan.
USAGE_DATA_DRIVEN_STYLING Set data ini akan digunakan untuk gaya visual berbasis data.

LocalFileSource

Detail tentang sumber data jika berupa file lokal.

Representasi JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Kolom
filename

string

Nama file dan ekstensi file yang diupload.

fileFormat

enum (FileFormat)

Format file yang sedang diupload.

FileFormat

Format file yang sedang diupload.

Enum
FILE_FORMAT_UNSPECIFIED Format file tidak ditentukan.
FILE_FORMAT_GEOJSON GeoJson.
FILE_FORMAT_KML File KML.
FILE_FORMAT_CSV CSV.

GcsSource

Detail tentang sumber data saat berada di Google Cloud Storage.

Representasi JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Kolom
inputUri

string

URI data sumber. Misalnya, gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Format file objek Google Cloud Storage. Ini terutama digunakan untuk validasi.

Status

Status versi set data.

Representasi JSON
{
  "state": enum (State),
  "errorMessage": string
}
Kolom
state

enum (State)

Enum status untuk status.

errorMessage

string

Pesan error yang menunjukkan alasan kegagalan. Kolom ini kosong jika set data tidak dalam status gagal.

Negara Bagian

Daftar status untuk versi set data. Jika nilai diubah di sini, sebaiknya perbarui metode utilitas Status.

Enum
STATE_UNSPECIFIED Status set data ini tidak ditetapkan.
STATE_IMPORTING Versi set data sedang diimpor.
STATE_IMPORT_SUCCEEDED Versi set data berhasil diimpor.
STATE_IMPORT_FAILED Versi set data gagal diimpor.
STATE_DELETING Set data sedang dalam proses dihapus.
STATE_DELETION_FAILED Status kegagalan penghapusan. Status ini menunjukkan bahwa penghapusan set data telah gagal. Penghapusan dapat dicoba lagi.
STATE_PROCESSING Status pemrosesan. Status ini merepresentasikan pencocokan dan pemrosesan awal set data untuk set data turunan.
STATE_PROCESSING_FAILED Status gagal pemrosesan. Status ini menunjukkan bahwa pemrosesan telah gagal dan dapat melaporkan error.
STATE_NEEDS_REVIEW Status perlu ditinjau. Status ini menunjukkan bahwa data tersedia untuk dipublikasikan dan ditayangkan ke penggunaan tertentu.
STATE_PUBLISHING Status publikasi. Status ini menunjukkan bahwa publikasi sedang berlangsung.
STATE_PUBLISHING_FAILED Status publikasi gagal. Status ini menunjukkan bahwa publikasi gagal. Publikasi dapat dicoba lagi.
STATE_COMPLETED Status yang telah selesai. Status ini mewakili set data yang tersedia untuk penggunaan tertentu.

Metode

create

Buat set data baru untuk project yang ditentukan.

delete

Menghapus set data yang ditentukan.

get

Dapatkan set data.

list

Mencantumkan semua set data untuk project yang ditentukan.

patch

Memperbarui metadata untuk set data.