Lewati ke konten utama
Halaman terjemahan

Halaman ini diterjemahkan dari bahasa Inggris dengan bantuan AI. Jika keduanya berbeda, versi bahasa Inggris menjadi acuannya.

query_library_get

Mengambil entri Query Library berdasarkan id yang dikembalikan oleh query_library_search.

Jika params dihilangkan atau kosong, alat ini mengembalikan template mentah, deklarasi parameter, dan catatan. Dengan objek params yang tidak kosong, server memvalidasi nilai tersebut dan menyubstitusikannya ke dalam template. Alat ini mengembalikan SQL hanya jika perenderan berhasil. Model tidak perlu menyubstitusikan nilai sendiri.

Alat ini tidak menjalankan SQL dan tidak memeriksa kredensial cloud. Validasi parameter yang dilakukannya berbeda dari validate_select_query, yang mengurai dan merencanakan pernyataan SELECT terhadap provider yang terinstal.

Lihat juga: [ Ringkasan MCP ] [ query_library_search ] [ run_select_query ] [ run_mutation_query ] [ run_lifecycle_operation ]


Input​

ArgumenWajibDeskripsi
idYaID kueri dari hasil pencarian, misalnya aws/s3/buckets-list.
paramsTidakObjek yang memetakan nama parameter yang dideklarasikan ke nilai. Hilangkan objek ini atau berikan {} untuk memeriksa template tanpa merendernya.
formatTidakPerenderan teks: markdown atau json. Jika dihilangkan, pengaturan render server yang digunakan (markdown secara default).

Parameter yang tidak dikenal ditolak. Parameter wajib yang tidak diberi nilai dan tidak memiliki nilai default dilaporkan di missing_params. Nilai yang diberikan diperiksa terhadap tipe dan batasan yang dideklarasikan; placeholder yang tidak terselesaikan dianggap error.


Output​

Tampilan teks default berupa blok KV yang berisi identitas, status mutasi, alat berikutnya, validitas, tautan sumber, serta template, SQL yang dirender, atau error jika ada. Gunakan payload terstruktur atau format: "json" untuk metadata lengkap:

FieldDeskripsi
id, title, descriptionIdentitas dan ringkasan entri.
mutation, verbApakah entri mengubah sumber daya dan, jika dideklarasikan, tipe operasi entri tersebut (select, mutation, atau lifecycle).
next_toolAlat eksekusi untuk entri: run_select_query, run_mutation_query, atau run_lifecycle_operation. Pengambilan entri tidak memanggil alat tersebut.
paramsDeklarasi parameter beserta nama, tipe, flag wajib, serta nilai default, deskripsi, contoh, enum, atau pola jika ada.
template, notesTemplate mentah dan catatan penulis, dikembalikan jika params dihilangkan atau kosong.
rendered, validApakah perenderan dicoba dan berhasil. Keduanya bernilai false saat memeriksa template mentah.
sqlSQL yang dirender, hanya ada setelah perenderan berhasil.
missing_params, unknown_params, errorsDetail validasi jika perenderan gagal. Jangan jalankan SQL sebelum masalah ini diselesaikan.
auth, permissionsJika dideklarasikan, variabel lingkungan kredensial dan izin asli provider yang diperlukan untuk eksekusi. Pengambilan entri itu sendiri tidak memerlukan keduanya.
cost, outputs, relatedJika dideklarasikan, petunjuk fan-out dan biaya, deskripsi kolom hasil, dan ID entri terkait.
doc_urlHalaman library yang dapat dibaca manusia.
source_tier, source_url, staleAsal konten: primary, fallback, atau snapshot, URL atau jalur tersematnya, dan apakah konten disajikan dari cache atau snapshot setelah pengambilan gagal.

ID yang tidak dikenal atau formatnya salah mengembalikan error. Gunakan query_library_search untuk menemukan ID yang valid.


Pengendalian​

Diizinkan di semua mode server, dengan tetap tunduk pada daftar izin alat yang dikonfigurasi. Mengambil atau merender template mutasi atau siklus hidup tidak berdampak apa pun di sisi cloud dan tidak memerlukan persetujuan. Menjalankan SQL yang dikembalikan merupakan panggilan terpisah yang diatur oleh mode server.


Contoh​

Periksa entri terlebih dahulu:

{
"id": "aws/s3/buckets-list"
}

Lalu berikan region perutean yang diwajibkan oleh entri tersebut:

{
"id": "aws/s3/buckets-list",
"params": {
"region": "us-east-1"
}
}

Setelah memeriksa rendered dan valid, gunakan validate_select_query untuk memvalidasi pernyataan SELECT yang dikembalikan. Jalankan pernyataan tersebut dengan alat yang disebutkan di next_tool, dengan meneruskan sql yang dikembalikan dan menetapkan source ke id entri library untuk atribusi. Kredensial dan izin provider diperlukan saat eksekusi.