REST Resource: projects.datasets

Tài nguyên: Tập dữ liệu

Biểu diễn một tài nguyên tập dữ liệu.

Biểu diễn dưới dạng 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.
}
Trường
name

string

Tên tài nguyên. Định dạng: dự án/{project}/datasets/{datasetId}

displayName

string

Tên dễ đọc, xuất hiện trong giao diện người dùng bảng điều khiển.

Phải là duy nhất trong một dự án.

description

string

Nội dung mô tả về tập dữ liệu này.

versionId

string

Mã phiên bản của tập dữ liệu.

usage[]

enum (Usage)

Trường hợp sử dụng được chỉ định cho tập dữ liệu này.

status

object (Status)

Chỉ có đầu ra. Trạng thái của phiên bản tập dữ liệu này.

createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tập dữ liệu được tạo lần đầu tiên.

updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm cập nhật siêu dữ liệu của tập dữ liệu gần đây nhất.

versionCreateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo phiên bản này.

versionDescription

string

Chỉ có đầu ra. Nội dung mô tả cho phiên bản tập dữ liệu này. Giá trị này được cung cấp khi nhập dữ liệu vào tập dữ liệu.

Trường kết hợp data_source. Thông tin chi tiết về nguồn dữ liệu cho tập dữ liệu. data_source chỉ có thể là một trong những trạng thái sau đây:
localFileSource

object (LocalFileSource)

Một nguồn tệp cục bộ cho tập dữ liệu cho một lượt tải lên.

gcsSource

object (GcsSource)

Nguồn tệp trên Google Cloud Storage cho tập dữ liệu trong một lần tải lên.

Cách sử dụng

Cách sử dụng chỉ định nơi dữ liệu sẽ được dùng để thông báo cách xử lý dữ liệu.

Enum
USAGE_UNSPECIFIED Cách sử dụng tập dữ liệu này chưa được thiết lập.
USAGE_DATA_DRIVEN_STYLING Tập dữ liệu này sẽ được dùng để định kiểu theo hướng dữ liệu.

LocalFileSource

Thông tin chi tiết về nguồn dữ liệu khi đó là một tệp cục bộ.

Biểu diễn dưới dạng JSON
{
  "filename": string,
  "fileFormat": enum (FileFormat)
}
Trường
filename

string

Tên tệp của tệp đã tải lên.

fileFormat

enum (FileFormat)

Định dạng của tệp đang được tải lên.

FileFormat

Định dạng của tệp đang được tải lên.

Enum
FILE_FORMAT_UNSPECIFIED Định dạng tệp không được chỉ định.
FILE_FORMAT_GEOJSON Tệp GeoJson.
FILE_FORMAT_KML tệp KML.
FILE_FORMAT_CSV CSV.

GcsSource

Thông tin chi tiết về nguồn dữ liệu khi nó nằm trong Google Cloud Storage.

Biểu diễn dưới dạng JSON
{
  "inputUri": string,
  "fileFormat": enum (FileFormat)
}
Trường
inputUri

string

URI dữ liệu nguồn. Ví dụ: gs://my_bucket/my_object.

fileFormat

enum (FileFormat)

Định dạng tệp của đối tượng Google Cloud Storage. Thông tin này chủ yếu được dùng để xác thực.

Trạng thái

Trạng thái của tập dữ liệu.

Biểu diễn dưới dạng JSON
{
  "state": enum (State),
  "errorMessage": string
}
Trường
state

enum (State)

Enum trạng thái của trạng thái.

errorMessage

string

Thông báo lỗi cho biết lý do không thành công. Giá trị này sẽ trống nếu tập dữ liệu không ở trạng thái không thành công.

Tiểu bang

Danh sách các trạng thái của tập dữ liệu.

Enum
STATE_UNSPECIFIED Trạng thái của tập dữ liệu này chưa được đặt.
STATE_IMPORTING Dữ liệu đang được nhập vào một tập dữ liệu.
STATE_IMPORT_SUCCEEDED Đã nhập dữ liệu vào tập dữ liệu thành công.
STATE_IMPORT_FAILED Không nhập được dữ liệu vào tập dữ liệu.
STATE_DELETING Tập dữ liệu đang trong quá trình bị xoá.
STATE_DELETION_FAILED Trạng thái xoá không thành công. Trạng thái này thể hiện rằng bạn chưa xoá được tập dữ liệu. Có thể thử xoá lại.
STATE_PROCESSING Dữ liệu đang được xử lý.
STATE_PROCESSING_FAILED Trạng thái xử lý không thành công. Trạng thái này thể hiện rằng quá trình xử lý không thành công và có thể báo cáo lỗi.
STATE_NEEDS_REVIEW Trạng thái này hiện không được sử dụng.
STATE_PUBLISHING Trạng thái xuất bản. Trạng thái này thể hiện rằng quá trình xuất bản đang diễn ra.
STATE_PUBLISHING_FAILED Trạng thái không xuất bản được. Trạng thái này thể hiện rằng không xuất bản được. Bạn có thể thử xuất bản lại.
STATE_COMPLETED Trạng thái hoàn tất. Trạng thái này thể hiện tập dữ liệu đang có sẵn cho mục đích sử dụng cụ thể của tập dữ liệu đó.

Phương thức

create

Tạo một tập dữ liệu mới cho dự án đã chỉ định.

delete

Xoá tập dữ liệu được chỉ định.

fetchDatasetErrors

Xem tất cả các lỗi của một tập dữ liệu.

get

Lấy tập dữ liệu.

list

Liệt kê mọi tập dữ liệu cho dự án đã chỉ định.

patch

Cập nhật siêu dữ liệu cho tập dữ liệu.