# SHOW

> SHOW у StackQL: перелічує провайдери, сервіси, ресурси й методи, генерує шаблони INSERT і показує версію, учасників і залежності запущеного двійкового файлу.

Source: https://stackql.io/uk/language-spec/show

Використовується для виведення списку елементів колекції, наприклад, усіх сервісів, доступних у провайдері, або всіх ресурсів, доступних у певному сервісі. Також показує версію, учасників і програмні залежності запущеного двійкового файлу StackQL.

Див. також:
[[ Ієрархія ресурсів StackQL ]](/getting-started/resource-hierarchy)

* * * 

## Синтаксис

*showStatement::=*

&nbsp;  
&nbsp;  

```sql
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.
```sql
-- 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, щоб отримати додаткові відомості.
```sql
-- 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` повертає, крім імені ресурсу, ще й опис ресурсу.
```sql
-- 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...|
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
| ...                                               | ...                                              | ...                                                          |
|---------------------------------------------------|--------------------------------------------------|--------------------------------------------------------------|
```

### Перегляд доступних методів ресурсу в сервісі провайдера
Виведіть список усіх методів, доступних для певного ресурсу.
```sql
-- 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`, як показано тут:

```sql
SHOW INSERT INTO google.compute.addresses;
```
**_Повертає:_**

```sql
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 }}'
```

> Повернуті поля можна обмежити лише тими, яких вимагає провайдер; приклади див. на сторінці [__Створення шаблонів інфраструктури__](/getting-started/templating).

> Потім цей шаблон можна використати разом із файлом даних `json` або `jsonnet`, щоб передати значення під час виконання; докладніше див. [__Використання змінних__](/getting-started/variables).

### Перегляд версії StackQL

Повертає версію запущеного процесу StackQL. Корисно в режимах shell, exec і сервера з мережевим протоколом Postgres, коли потрібно переконатися, яка збірка відповідає на запити. Ці самі відомості також надає інструмент MCP `server_info`.

```sql
-- Returns the version of the running StackQL process
SHOW VERSION;
```
**_Повертає:_**

```
|---------|
| version |
|---------|
| 1.0.888 |
|---------|
```

Скористайтеся необов'язковим ключовим словом `EXTENDED`, щоб також отримати коміт git, позначку часу збірки й платформу збірки:

```sql
-- 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 під час виконання.

```sql
SHOW CONTRIBUTORS;
SHOW EXTENDED CONTRIBUTORS;
```

| Стовпець | Опис |
| --- | --- |
| `contributor` | Ім'я користувача GitHub |
| `contributions` | Кількість внесків, записана в знімку; включається з `EXTENDED` |

### Виведення списку програмних залежностей двійкового файлу

Повертає офлайнову інвентаризацію модулів Go, включених у запущений виконуваний файл StackQL. Це полегшений перелік компонентів програмного забезпечення (SBOM) для двійкового файлу, до якого користувачі й агенти можуть виконувати запити під час роботи StackQL. Він охоплює прямі й транзитивні залежності Go; встановлені визначення провайдерів, окремі обгортки, інструменти CI, модулі лише для тестування, образи контейнерів і пакети операційної системи до нього не входять.

```sql
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`, щоб шукати за фактичним іменем модуля, початковим іменем модуля або описом:

```sql
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 розгортання, ні висновком про відповідність ліцензійним вимогам.

* * *
