Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
SHOW
Використовується для виведення списку елементів колекції, наприклад, усіх сервісів, доступних у провайдері, або всіх ресурсів, доступних у певному сервісі. Також показує версію, учасників і програмні залежності запущеного двійкового файлу StackQL.
Див. також: [ Ієрархія ресурсів StackQL ]
Синтаксис
showStatement::=
SHOW [ EXTENDED ]
{ PROVIDERS | SERVICES | RESOURCES | METHODS }
[ { IN | FROM } { <provider> | <service> | <resource> } ]
[ { LIKE '<pattern>' | WHERE <expression> } ];
SHOW [ EXTENDED ] INSERT INTO <resource>;
SHOW [ EXTENDED ] VERSION;
SHOW [ EXTENDED ] CONTRIBUTORS;
SHOW [ EXTENDED ] DEPENDENCIES [ LIKE '<pattern>' ];
VERSION, CONTRIBUTORS і DEPENDENCIES не потребують налаштування провайдерів чи автентифікації. DEPENDENCIES підтримує лише необов'язкове речення LIKE; IN, FROM, WHERE і LIMIT не підтримуються.
Приклади
Виведення списку всіх провайдерів
Виведіть список провайдерів, доступних у локальному середовищі StackQL: завантажених із реєстру провайдерів, а також провайдерів, вбудованих у StackQL.
-- Returns the providers available locally
SHOW PROVIDERS;
Повертає:
|----------------------|--------------|
| name | version |
|----------------------|--------------|
| aws | v26.03.00379 |
|----------------------|--------------|
| databricks_account | v26.03.00381 |
|----------------------|--------------|
| databricks_workspace | v26.03.00381 |
|----------------------|--------------|
| google | v25.12.00357 |
|----------------------|--------------|
| k8s | v24.12.00276 |
|----------------------|--------------|
Виведення списку всіх сервісів провайдера
Виведіть список усіх сервісів, доступних у певному провайдері; скористайтеся необов'язковим ключовим словом EXTENDED, щоб отримати додаткові відомості.
-- Returns all services available in a provider
SHOW EXTENDED SERVICES IN google;
Повертає:
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| id | name | title | description |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| compute:v25.12.00357 | compute | Compute Engine API | Creates and runs virtual machines on Google Cloud Platform. |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| storage:v25.12.00357 | storage | Cloud Storage API | Stores and retrieves unstructured object data at global sc... |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| bigquery:v25.12.00357 | bigquery | BigQuery API | A data platform for customers to create, manage, share and... |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| aiplatform:v25.12.00357 | aiplatform | Vertex AI API | Train high-quality custom machine learning models with min... |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| geminicloudassist:v25.12.00357 | geminicloudassist | Gemini Cloud Assist API | The AI-powered assistant for Google Cloud. |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
| ... | ... | ... | ... |
|--------------------------------|-------------------|-------------------------|---------------------------------------------------------------|
Виведення списку всіх ресурсів у сервісі провайдера
Виведіть список усіх ресурсів, доступних у певному сервісі провайдера. Необов'язкове ключове слово EXTENDED повертає, крім імені ресурсу, ще й опис ресурсу.
-- Returns all resources available in a provider service
SHOW EXTENDED RESOURCES IN google.compute;
Повертає:
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| name | id | description |
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| instances | google.compute.instances | Virtual machine instances running on Google Cloud Platform...|
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| disks | google.compute.disks | Persistent block storage volumes attached to compute inst... |
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| networks | google.compute.networks | Virtual private cloud (VPC) networking resources and conf... |
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| backend_services | google.compute.backend_services | Backend services used for load balancing and traffic distr...|
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| firewalls | google.compute.firewalls | Firewall rules controlling ingress and egress network traf...|
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| ... | ... | ... |
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
Перегляд доступних методів ресурсу в сервісі провайдера
Виведіть список усіх методів, доступних для певного ресурсу.
-- Returns all methods available for a provider resource
SHOW EXTENDED METHODS IN google.compute.instances;
Повертає:
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| MethodName | RequiredParams | SQLVerb | description |
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| list | project, zone | SELECT | Retrieves the list of instances contained...|
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| insert | project, zone | INSERT | Creates an instance resource in the speci...|
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| delete | instance, project, zone | DELETE | Deletes the specified Instance resource... |
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| start | instance, project, zone | EXEC | Starts an instance that was stopped using...|
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| stop | instance, project, zone | EXEC | Stops a running instance, shutting it dow...|
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
| ... | ... | ... | ... |
|----------------------------------------|--------------------------------|---------|---------------------------------------------|
Генерування шаблону INSERT за допомогою команди SHOW INSERT
Команду SHOW можна використати для генерування шаблонів інструкцій INSERT, як показано тут:
SHOW INSERT INTO google.compute.addresses;
Повертає:
INSERT INTO google.compute.addresses(
project,
region,
data__address,
data__addressType,
data__description,
data__ipVersion,
data__name,
data__network,
data__networkTier,
data__prefixLength,
data__purpose,
data__subnetwork
)
SELECT
'{{ .values.project }}',
'{{ .values.region }}',
'{{ .values.data__address }}',
'{{ .values.data__addressType }}',
'{{ .values.data__description }}',
'{{ .values.data__ipVersion }}',
'{{ .values.data__name }}',
'{{ .values.data__network }}',
'{{ .values.data__networkTier }}',
{{ .values.data__prefixLength }},
'{{ .values.data__purpose }}',
'{{ .values.data__subnetwork }}'
Повернуті поля можна обмежити лише тими, яких вимагає провайдер; приклади див. на сторінці Створення шаблонів інфраструктури.
Потім цей шаблон можна використати разом із файлом даних
jsonабоjsonnet, щоб передати значення під час виконання; докладніше див. Використання змінних.
Перегляд версії StackQL
Повертає версію запущеного процесу StackQL. Корисно в режимах shell, exec і сервера з мережевим протоколом Postgres, коли потрібно переконатися, яка збірка відповідає на запити. Ці самі відомості також надає інструмент MCP server_info.
-- Returns the version of the running StackQL process
SHOW VERSION;
Повертає:
|---------|
| version |
|---------|
| 1.0.888 |
|---------|
Скористайтеся необов'язковим ключовим словом EXTENDED, щоб також отримати коміт git, позначку часу збірки й платформу збірки:
-- Returns version plus build provenance
SHOW EXTENDED VERSION;
Повертає:
|---------|---------|----------------------|----------|
| version | commit | build_date | platform |
|---------|---------|----------------------|----------|
| 1.0.888 | f7b4116 | 2026-11-05T00:26:03Z | Windows |
|---------|---------|----------------------|----------|
Інструкція
SHOW VERSIONне потребує налаштування провайдерів, реєстру чи автентифікації, і її безпечно виконувати в будь-якому сеансі.
Виведення списку учасників StackQL
Повертає рейтинг учасників, вбудований у запущений двійковий файл StackQL. Знімок відзначає учасників GitHub, які є людьми й поставили зірку репозиторію StackQL, і впорядковує їх за кількістю внесків, від найбільшої. Знімок фіксований для кожної збірки й не виконує запитів до GitHub під час виконання.
SHOW CONTRIBUTORS;
SHOW EXTENDED CONTRIBUTORS;
| Стовпець | Опис |
|---|---|
contributor | Ім'я користувача GitHub |
contributions | Кількість внесків, записана в знімку; включається з EXTENDED |
Виведення списку програмних залежностей двійкового файлу
Повертає офлайнову інвентаризацію модулів Go, включених у запущений виконуваний файл StackQL. Це полегшений перелік компонентів програмного забезпечення (SBOM) для двійкового файлу, до якого користувачі й агенти можуть виконувати запити під час роботи StackQL. Він охоплює прямі й транзитивні залежності Go; встановлені визначення провайдерів, окремі обгортки, інструменти CI, модулі лише для тестування, образи контейнерів і пакети операційної системи до нього не входять.
SHOW DEPENDENCIES;
SHOW EXTENDED DEPENDENCIES;
Стовпці за замовчуванням: name, version, license і description. Ключове слово EXTENDED додає решту стовпців, наведених нижче, не змінюючи того, які рядки повертаються.
| Стовпець | Опис |
|---|---|
name | Фактичний шлях модуля Go: шлях заміни, якщо застосовується заміна модуля Go |
version | Точна версія модуля, включно з версіями попередніх випусків і псевдоверсіями |
license | Виявлений ідентифікатор ліцензії; UNKNOWN, якщо ліцензію не визначено або вона неоднозначна |
description | Опис компонента, якщо він доступний |
source_url | URL репозиторію з вихідним кодом; включається з EXTENDED |
license_url | URL файлу ліцензії, закріплений за тегом модуля або ревізією вихідного коду; включається з EXTENDED |
purl | Package URL, що ідентифікує модуль і версію; включається з EXTENDED |
checksum | Контрольна сума модуля Go з префіксом h1:, а не дайджест SHA-256 виконуваного файлу чи архіву; включається з EXTENDED |
original_name | Початково запитаний шлях модуля, якщо застосовується заміна; включається з EXTENDED |
original_version | Початково запитана версія, якщо застосовується заміна; включається з EXTENDED |
Рядки впорядковано за фактичним іменем модуля, а потім за версією. Для замін використовуються версія, контрольна сума й атрибуція заміни. Для модулів без замін original_name і original_version мають значення NULL. Інші недоступні метадані також мають значення NULL, за винятком невизначених ліцензій, для яких указується UNKNOWN. Заміни на шляхи локальної файлової системи не мають вигаданих версії, URL чи контрольної суми.
Скористайтеся реченням LIKE, щоб шукати за фактичним іменем модуля, початковим іменем модуля або описом:
SHOW DEPENDENCIES LIKE '%stackql%';
SHOW EXTENDED DEPENDENCIES LIKE '%vitess%';
SHOW EXTENDED DEPENDENCIES LIKE 'github.com/chzyer/readline';
Зіставлення виконується без урахування регістру. % відповідає нулю або більшій кількості символів, а _ відповідає рівно одному символу. Пошук у стовпцях ліцензії та версії не виконується. Одинарну лапку всередині рядкового літерала SQL потрібно подвоювати; після декодування рядка SQL зворотні скісні риски сприймаються буквально й не екранують символи узагальнення LIKE.
Якщо жоден модуль не відповідає шаблону, результат містить нуль рядків. У форматі CSV зберігаються заголовки стовпців, клієнти мережевого протоколу PostgreSQL зберігають метадані стовпців, а вивід JSON дорівнює null.
Інвентаризація поєднує метадані, вбудовані під час збирання, з інформацією про збірку Go виконуваного файлу. Для запитів не потрібні доступ до мережі, встановлений Go, локальна копія вихідного коду чи кеш модулів. Збірки без згенерованих метаданих усе одно повідомляють про скомпоновані модулі, а відсутня атрибуція відображається як UNKNOWN або NULL.
Вивід охоплює лише залежності Go двійкового файлу. Він не містить відношень між залежностями, не експортує документ SPDX чи CycloneDX і не є ні повним SBOM розгортання, ні висновком про відповідність ліцензійним вимогам.