REST Resource: projects.datasets

Zasób: Dataset

Reprezentacja zasobu zbioru danych.

Zapis 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.
}
Pola
name

string

Nazwa zasobu. Format: projects/{project}/datasets/{datasetId}

displayName

string

Czytelna nazwa wyświetlana w interfejsie konsoli.

Musi być unikalna w obrębie projektu.

description

string

Opis tego zbioru danych.

versionId

string

Identyfikator wersji zbioru danych.

usage[]

enum (Usage)

Określony przypadek użycia dla tego zbioru danych.

status

object (Status)

Tylko dane wyjściowe. Stan tej wersji zbioru danych.

createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia zbioru danych.

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej aktualizacji metadanych zbioru danych.

versionCreateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tej wersji.

versionDescription

string

Tylko dane wyjściowe. Opis tej wersji zbioru danych. Jest on podawany podczas importowania danych do zbioru danych.

Pole sumy data_source. Szczegółowe informacje o źródle danych zbioru danych. data_source może mieć tylko jedną z tych wartości:
localFileSource

object (LocalFileSource)

Lokalne źródło pliku zbioru danych przeznaczonego do pojedynczego przesłania.

gcsSource

object (GcsSource)

Źródło pliku w Google Cloud Storage dla zbioru danych przeznaczonego do pojedynczego przesłania.

Wykorzystanie

Użycie określa, gdzie dane mają być używane przy przetwarzaniu danych.

Wartości w polu enum
USAGE_UNSPECIFIED Wykorzystanie tego zbioru danych nie zostało ustawione.
USAGE_DATA_DRIVEN_STYLING Ten zbiór danych będzie używany na potrzeby stylu opartego na danych.

LocalFileSource

Szczegółowe informacje o źródle danych, jeśli jest to plik lokalny.

Zapis JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Pola
filename

string

Nazwa przesłanego pliku.

fileFormat

enum (FileFormat)

Format przesyłanego pliku.

FileFormat

Format przesyłanego pliku.

Wartości w polu enum
FILE_FORMAT_UNSPECIFIED Nieokreślony format pliku.
FILE_FORMAT_GEOJSON GeoJSON.
FILE_FORMAT_KML KML.
FILE_FORMAT_CSV plik CSV.

GcsSource

Szczegółowe informacje o źródle danych, gdy znajduje się w Google Cloud Storage.

Zapis JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Pola
inputUri

string

Identyfikator URI danych źródłowych. Na przykład: gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Format pliku obiektu Google Cloud Storage. Służy on głównie do weryfikacji.

Stan

Stan zbioru danych.

Zapis JSON
{
  "state": enum (State),
  "errorMessage": string
}
Pola
state

enum (State)

Enum stanów dla poszczególnych stanów.

errorMessage

string

Komunikat o błędzie wskazujący przyczynę niepowodzenia. Jeśli zbiory danych nie są w stanie błędu, jest pusta.

Stan

Lista stanów zbioru danych.

Wartości w polu enum
STATE_UNSPECIFIED Stan tego zbioru danych nie jest ustawiony.
STATE_IMPORTING Dane są importowane do zbioru danych.
STATE_IMPORT_SUCCEEDED Dane zostały zaimportowane do zbioru danych.
STATE_IMPORT_FAILED Nie udało się zaimportować danych do zbioru danych.
STATE_DELETING Trwa usuwanie zbioru danych.
STATE_DELETION_FAILED Nie udało się usunąć. Ten stan oznacza, że nie udało się usunąć zbioru danych. Usunięcie może być ponawiane.
STATE_PROCESSING Dane są przetwarzane.
STATE_PROCESSING_FAILED Niepowodzenie przetwarzania. Ten stan oznacza, że przetwarzanie nie powiodło się i może zgłaszać błędy.
STATE_NEEDS_REVIEW Ten stan nie jest obecnie używany.
STATE_PUBLISHING Stan publikacji. Ten stan oznacza, że trwa publikowanie.
STATE_PUBLISHING_FAILED Nie udało się opublikować. Ten stan oznacza, że nie udało się opublikować. Można spróbować opublikować ją ponownie.
STATE_COMPLETED Stan ukończenia. Ten stan reprezentuje zbiór danych dostępny na potrzeby konkretnego użycia.

Metody

create

Tworzy nowy zbiór danych dla określonego projektu.

delete

Usuwa określony zbiór danych.

fetchDatasetErrors

Pobiera wszystkie błędy zbioru danych.

get

Pobiera zbiór danych.

list

Wyświetla listę wszystkich zbiorów danych w podanym projekcie.

patch

Aktualizuje metadane zbioru danych.