Chuyển tới nội dung chính
Trang được dịch

Trang này được dịch từ tiếng Anh với sự hỗ trợ của AI. Nếu hai bản có chỗ khác nhau, hãy lấy phiên bản tiếng Anh làm chuẩn.

DESCRIBE

Mô tả một tài nguyên hoặc một phương thức cụ thể của một tài nguyên.

Xem thêm: [ Phân cấp tài nguyên StackQL ]


Cú pháp​

describeStatement::=

DESCRIBEMETHODEXTENDEDmultipartIdentifier';'

   

DESCRIBE [ METHOD ] [ EXTENDED ] <multipartIdentifier> ;
DESC [ EXTENDED ] <multipartIdentifier> ;

DESC được chấp nhận làm bí danh của DESCRIBE khi mô tả một tài nguyên; DESCRIBE METHOD yêu cầu từ khóa đầy đủ.

Phản hồi​

CộtMô tả
nameTên trường
typeKiểu dữ liệu (string, integer, boolean, number, object, array)
descriptionMô tả trường (nếu có chỉ định EXTENDED)

Ví dụ​

Câu lệnh DESCRIBE cơ bản​

Chạy một câu lệnh DESCRIBE cơ bản để liệt kê các trường trong một tài nguyên từ một phiên đã xác thực.

-- Show the available fields in a Compute Engine resource
DESCRIBE google.compute.instances;

Câu lệnh DESCRIBE mở rộng​

Chạy một câu lệnh DESCRIBE mở rộng để liệt kê các trường trong một tài nguyên cùng mô tả của chúng từ một phiên đã xác thực.

-- Show the available fields in a Compute Engine resource
DESCRIBE EXTENDED google.compute.instances;

Bí danh DESC​

DESC là dạng viết tắt của DESCRIBE trên một tài nguyên, có hoặc không có EXTENDED. Câu lệnh này được coi là câu lệnh chỉ đọc ở mọi nơi DESCRIBE được coi như vậy, kể cả công cụ run_select_query của máy chủ MCP ở chế độ read_only và safe.

-- Same result as DESCRIBE EXTENDED google.compute.instances
DESC EXTENDED google.compute.instances;

Câu lệnh DESCRIBE METHOD cơ bản​

Kiểm tra chi tiết một phương thức của một tài nguyên. Kết quả bao gồm các tham số đầu vào và các trường phản hồi, với cấu trúc lồng nhau được hiển thị trong cột shape.

-- Show the inputs and outputs for the buckets.get method
DESCRIBE METHOD google.storage.buckets.get;

Câu lệnh DESCRIBE METHOD mở rộng​

Chạy một câu lệnh DESCRIBE METHOD mở rộng để có thêm mô tả của từng trường bên cạnh dạng dữ liệu.

-- Show inputs, outputs, and descriptions for the buckets.insert method
DESCRIBE METHOD EXTENDED google.storage.buckets.insert;

Khám phá payload của INSERT​

DESCRIBE METHOD là cách chuẩn để tìm hiểu một INSERT (hoặc bất kỳ phương thức thay đổi dữ liệu nào) chấp nhận những trường nào. Cột shape chứa cấu trúc lồng nhau mà tác nhân và con người có thể dùng để dựng payload trong một truy vấn.

-- See what google.compute.instances.insert requires
DESCRIBE METHOD EXTENDED google.compute.instances.insert;