REST Resource: projects.datasets

Zasób: Dataset

Reprezentacja zbioru danych platformy map.

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, projects/{project}/datasets/{dataset_id}
displayName

string

Czytelna nazwa wyświetlana w interfejsie konsoli.
description

string

Opis tego zbioru danych.
versionId

string

Identyfikator wersji zbioru danych.
usage[]

enum (Usage)

Wyznaczone przypadki użycia 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.

Sygnatura czasowa w formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

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

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
versionCreateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia tej wersji zbioru danych. (wystąpiło podczas importowania danych do zbioru danych)

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
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óły dotyczące źródła danych zbioru danych. data_source może być tylko jednym z tych elementów:
localFileSource

object (LocalFileSource)

Lokalny plik źródłowy zbioru danych do przesłania pojedynczego pliku.
gcsSource

object (GcsSource)

Źródło pliku Google Cloud Storage dla zbioru danych na potrzeby pojedynczego przesyłania.

Wykorzystanie

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

Wartości w polu enum
USAGE_UNSPECIFIED Korzystanie z tego zbioru danych nie jest 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 i rozszerzenie 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 Plik GeoJSON.
FILE_FORMAT_KML Plik KML.
FILE_FORMAT_CSV plik CSV.

GcsSource

Szczegóły źródła danych 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. Jest on używany głównie do weryfikacji.

Stan

Stan wersji 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. Jest puste, jeśli zbiór danych nie jest w stanie błędu.

Stan

Lista stanów wersji zbioru danych. Jeśli wartości zostaną tutaj zmienione, rozważ zaktualizowanie metod narzędzia Status.

Wartości w polu enum
STATE_UNSPECIFIED Stan tego zbioru danych nie jest ustawiony.
STATE_IMPORTING Importuję wersję zbioru danych.
STATE_IMPORT_SUCCEEDED Wersja zbioru danych została zaimportowana.
STATE_IMPORT_FAILED Nie udało się zaimportować wersji zbioru danych.
STATE_DELETING Zbiór danych jest w trakcie usuwania.
STATE_DELETION_FAILED Nie udało się usunąć. Ten stan oznacza, że nie udało się usunąć zbioru danych. Usunięcie można powtórzyć.
STATE_PROCESSING Stan przetwarzania. Ten stan reprezentuje początkowe dopasowywanie i przetwarzanie zbiorów danych do zbiorów danych pochodnych.
STATE_PROCESSING_FAILED Stan przetwarzania nie powiodło się. Ten stan oznacza, że przetwarzanie nie powiodło się i mogą wystąpić błędy.
STATE_NEEDS_REVIEW Stan „wymaga sprawdzenia”. Ten stan oznacza, że dane są dostępne do publikacji i mogą być używane do określonego celu.
STATE_PUBLISHING Stan publikacji. Ten stan oznacza, że trwa publikowanie.
STATE_PUBLISHING_FAILED Nie udało się opublikować. Ten stan oznacza, że publikacja się nie udała. 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

 Utwórz nowy zbiór danych dla określonego projektu.

delete

 usunąć określony zbiór danych.

get

 Pobierz zbiór danych.

list

 Wyświetlanie listy wszystkich zbiorów danych w podanym projekcie.

patch

 Zaktualizuj metadane zbioru danych.