Поиск по сайту:

Подключите Snowflake к клиенту SnowSQL CLI

Доступ к Snowflake с помощью клиента CLI SnowSQL

В этом уроке мы узнаем, что такое SnowSQL, как установить SnowSQL в Linux и Windows и, наконец, как подключиться к Snowflake с помощью SnowSQL.

Прежде чем начать работу со SnowSQL, я предлагаю вам просмотреть следующую ссылку, чтобы узнать, что такое Snowflake и как создать бесплатную пробную учетную запись в Snowflake.

  • Введение в хранилище данных Snowflake

1. Что такое SnowSQL?

SnowSQL — это клиент CLI для Snowflake, который можно использовать для взаимодействия со Snowflake и выполнения операций DDL и DML, а также операций загрузки и выгрузки данных.

2. Установите SnowSQL в Linux.

Мы уже создали бесплатную пробную учетную запись. Откройте пользовательский интерфейс Snowflake, чтобы загрузить установщик SnowSQL. Ниже приведен URL-адрес нашей бесплатной пробной учетной записи.

  • https://uz64318.southeast-asia.azure.snowflakecomputing.com/console#/internal/worksheet

Откройте веб-браузер и перейдите по URL-адресу для доступа к веб-интерфейсу Snowflake. URL-адрес уникален для каждой учетной записи.

В веб-интерфейсе Snowflake нажмите «Справка» и выберите опцию «Загрузить».

Выберите вариант загрузки из веб-интерфейса Snowflake.

Вы можете войти в репозиторий Snowflake и загрузить пакет SnowSQL. В противном случае вы можете загрузить пакет SnowSQL rpm из репозитория ниже.

  • https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/index.html

Загрузите CLI-клиент SnowSQL

Щелкните правой кнопкой мыши ссылку на последнюю версию клиента SnowSQL CLI для Linux и выберите «Копировать адрес ссылки».

Загрузите CLI-клиент SnowSQL для Linux

Используйте wget, чтобы загрузить RPM-файл SnowSQL CLI.

wget https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/1.2/linux_x86_64/snowflake-snowsql-1.2.21-1.x86_64.rpm

Установите SnowSQL с помощью приведенной ниже команды от имени пользователя root.

# rpm -i Snowflake-snowsql-1.2.21-1.x86_64.rpm

После установки проверьте установку, проверив версию SnowSQL.

snowsql -v

Проверьте версию SnowSQL

Вы можете отобразить раздел справки клиента SnowSQL, выполнив следующую команду:

snowsql

Отобразить справку SnowSQL

3. Подключите Snowflake с помощью SnowSQL в Linux.

Используйте приведенный ниже синтаксис для подключения Snowflake из окна терминала:

snowsql -a <account-name> -u <username>

Вы можете получить имя учетной записи по URL-адресу, который является уникальным для вашей учетной записи. Имя учетной записи состоит из уникального номера учетной записи и региона Cloud.

Имя учетной записи Snowflake и имя пользователя

Как вы можете видеть на скриншоте выше, вот мой веб-адрес Snowflake, учетная запись и имя пользователя для Snowflake.

  • URL-адрес учетной записи: https://uz64318.southeast-asia.azure.snowflakecomputing.com/console#/internal/worksheet
  • Имя учетной записи: uz64318.southeast-asia.azure
  • Имя пользователя: OSTECHNIX

Подключите Снежинку, используя следующую команду.

snowsql -a uz64318.southeast-asia.azure -u OSTECHNIX

Вам будет предложено ввести пароль вашей учетной записи.

Password:
* SnowSQL * v1.2.21
Type SQL statements or !help
OSTECHNIX#COMPUTE_WH@(no database).(no schema)>

Подключите Snowflake с помощью SnowSQL в Linux

Примечание. В этой статье мы использовали Powershell в качестве CLI для дальнейшей демонстрации. В промышленной практике реального времени в основном конечные пользователи/бизнес-пользователи будут иметь машины под управлением Windows. Таким образом, большинство вариантов использования будут опираться на Powershell. Все запросы/синтаксис SnowSQL одинаковы как в Powershell, так и в Linux bash.

4. Установите SnowSQL в Windows

Загрузка клиента SnowSQL CLI аналогична описанной выше. В веб-интерфейсе Snowflake нажмите «Справка» и выберите опцию «Загрузить».

Выберите вариант загрузки из веб-интерфейса Snowflake.

Нажмите ссылку на репозиторий Snowflake.

Хранилище снежинок

После того, как вы нажмете «Репозиторий Snowflake», вы будете перенаправлены на страницу репозитория SnowSQL, где сможете загрузить установщик. Здесь я скачал последнюю версию установщика для ОС Windows.

Вы можете использовать URL-адрес ниже, чтобы загрузить установщик в соответствии с моделью вашей ОС.

  • https://sfc-repo.snowflakecomputing.com/snowsql/bootstrap/index.html

Файлы установки SnowSQL

После загрузки пакета установщика вы можете установить его напрямую, запустив.

Установите SnowSQL в Windows

После установки вы откроется страница ниже, на которой можно получить инструкции по подключению учетной записи Snowflake.

Установка SnowSQL завершена

Откройте новый терминал (cmd) или Powershell. Здесь я использовал Powershell, как рекомендовано, поскольку Powershell — это более продвинутая версия cmd в Windows.

Откройте Windows Powershell от имени администратора.

Запустите Powershell от имени администратора

Вы можете получить раздел справки Snowsql, используя следующую команду:

PS C:\WINDOWS\system32> snowsql

Посмотреть раздел справки SnowSQL

Вы можете проверить версию SnowSQL, чтобы убедиться в успешной установке.

PS C:\WINDOWS\system32> Snowsql -v
Версия: 1.2.21
PS C:\WINDOWS\system32>

5. Доступ к Snowflake с помощью клиента SnowSQL CLI.

Используйте приведенный ниже синтаксис, чтобы подключить Snowflake из вашей Powershell, как мы это делали в оболочке Linux bash.

snowsql -a <your_account_name> -u <username>

Здесь имя моей учетной записи — uz64318.southeast-asia.azure, а имя пользователя — OSTECHNIX.

Соедините снежинку, используя нить ниже:

PS C:\WINDOWS\system32> snowsql -a uz64318.southeast-asia.azure  -u OSTECHNIX

Вам будет предложено ввести пароль вашей учетной записи.

Password:
* SnowSQL * v1.2.21
Type SQL statements or !help
OSTECHNIX#COMPUTE_WH@(no database).(no schema)>

Доступ к Snowflake с помощью SnowSQL

Snowflake был подключен через SnowSQL пользователем OSTECHNIX. По умолчанию он будет подключен к хранилищу данных по умолчанию 'COMPUTE_WH'.

Вы можете указать имя базы данных и имя схемы в строке подключения при подключении Snowflake.

snowsql -a uz64318.southeast-asia.azure  -u OSTECHNIX -d <databaseName> -s <schemaName>

Используйте команду ниже, чтобы проверить доступные базы данных. Для демонстрационных целей будет несколько баз данных по умолчанию.

OSTECHNIX#COMPUTE_WH@(no database).(no schema)>show databases;

Показать доступные базы данных

Используйте команду ниже для подключения к определенной базе данных.

OSTECHNIX#COMPUTE_WH@(no database).(no schema)>use SNOWFLAKE_SAMPLE_DATA ;
+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
1 Row(s) produced. Time Elapsed: 0.562s

Подключиться к определенной базе данных

Проверьте доступные схемы в базе данных "SNOWFLAKE_SAMPLE_DATA". Как мы подключились к этой базе данных, это будет отражено в оболочке.

OSTECHNIX#COMPUTE_WH@SNOWFLAKE_SAMPLE_DATA.(no schema)> show SCHEMAS;

Показать доступные схемы

Подключитесь к любой конкретной схеме, используя команду ниже.

OSTECHNIX#COMPUTE_WH@SNOWFLAKE_SAMPLE_DATA.(no schema)>use SNOWFLAKE_SAMPLE_DATA.WEATHER;

Подключиться к определенной схеме

Теперь пользователь OSTECHNIX подключен к хранилищу COMPUTE_WH, базе данных SNOWFLAKE_SAMPLE_DATA и схеме WEATHER.

6. Создайте хранилище данных

Склад — это вычислительная единица в Snowflake. Пожалуйста, обратитесь к нашей предыдущей статье, чтобы получить концептуальное представление о складе в Snowflake и его размере с моделью ценообразования.

В Snowflake большинство команд DDL можно выполнить тремя способами:

  1. Снежной SQL,
  2. Рабочий лист на приборной панели,
  3. в веб-интерфейсе.

6.1. Создайте хранилище данных с помощью SnowSQL

Давайте создадим новое хранилище с именем «ostech_demo».

Для этого выполните следующую команду:

OSTECHNIX#COMPUTE_WH@SNOWFLAKE_SAMPLE_DATA.WEATHER>create or replace warehouse ostech_demo with
                                                   warehouse_size='X-SMALL' 
                                                   auto_suspend = 180 
                                                   auto_resume = true
                                                   initially_suspended = true;

Создать склад

Складские свойства:

  • Warehouse_size – размер склада.
  • Auto_suspend — работа хранилища будет приостановлена через определенные секунды.
  • Авто_возобновление – True | Ложь: хранилище будет запускаться автоматически при отправке инструкции SQL, если для этого свойства установлено значение True.
  • Первоначально_приостановлено – правда | False: состояние склада приостанавливается при создании, если для этого свойства установлено значение True.

Проверить созданный Склад можно с помощью команды «Показать».

OSTECHNIX#OSTECH_DEMO@SNOWFLAKE_SAMPLE_DATA.WEATHER>show WAREHOUSES;

Показать склады из командной строки

Кроме того, вы можете проверить в WebUI. В веб-интерфейсе Snowflake выберите параметр Склад.

Показать склады из WebUI

6.2. Создать хранилище данных на листе

Ту же команду «Создать» также можно запустить на рабочем листе на панели инструментов Snowflake. Этот рабочий лист представляет собой встроенный клиент SQL, поставляемый со Snowflake.

Создайте еще один склад «ostech_demo_2», используя рабочий лист.

create or replace warehouse ostech_demo_2 with
    warehouse_size='X-SMALL'
    auto_suspend = 180
    auto_resume = true
    initially_suspended = true;

Создать склад из информационной панели Snowflake

Проверяем созданный Склад:

Просмотр складов на панели инструментов Snowflake

6.3. Создать хранилище данных из WebUI

Вы также можете создать склад, используя опцию «Создать», доступную на вкладке «Склад».

Создать склад

Введите параметры и нажмите «Готово».

Введите данные склада

Новый Склад создан. Проверьте это на вкладке «Склады».

Посмотреть склады

Заключение

В этой статье мы обсудили, как установить SnowSQL (CLI Snowflake) в Linux и Windows, как подключить Snowflake с помощью SnowSQL и, наконец, как создать хранилище тремя различными способами.

В следующих статьях мы узнаем о других действиях по управлению базой данных, таких как создание базы данных/таблиц, загрузка данных, управление пользователями и управление доступом.

Читать далее:

  • Описание управления доступом на основе ролей (RBAC) Snowflake

Ресурсы:

  • https://docs.snowflake.com/en/user-guide/snowsql-start.html
  • https://docs.snowflake.com/en/sql-reference/sql/create-warehouse.html

Статьи по данной тематике