Подключение к кластеру YTsaurus

Статья создана

Yandex Cloud

Обновлена 17 июля 2026 г.

Открыть в Markdown

Примеры строк подключения
- Bash
- Python

К кластеру YTsaurus можно подключиться:

С виртуальных машин Yandex Cloud.
Через интернет по HTTPS.

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

Примеры для Linux проверялись в следующем окружении:

Виртуальная машина в Yandex Cloud с Ubuntu 20.04 LTS.
Bash: 5.0.16.
Python: 3.8.2; pip3: 20.0.2.

Bash

Перед подключением:

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
Установите YTsaurus CLI по инструкции.

Установите зависимости:

sudo apt update && sudo apt install -y python3 python3-pip && \
pip3 install ytsaurus-client-yc-auth

Подключение с пользовательской ВМ

Подключение из интернета

Получите конфигурационный файл доступа с помощью команды YC CLI:

yc managed-ytsaurus cluster get-configuration <имя_или_идентификатор_кластера> --private

Пример конфигурационного файла

{
  auth_class = {
    module_name = "yc_managed_ytsaurus_auth";
    class_name = "IamTokenAuth";
  };
  proxy = {
    url = "http://hp.<идентификатор_кластера_YTsaurus>.ytsaurus.mdb.yandexcloud.net:32100";
    network_name = "external";
    http_proxy_role = "default";
  }
}

Конфигурационный файл будет сохранен по пути ~/.yt/config.

Идентификатор кластера можно запросить со списком кластеров в каталоге.

Выполните запрос списка содержимого корневого каталога:
```
yt list /
```

Получите конфигурационный файл доступа с помощью команды YC CLI:
```
yc managed-ytsaurus cluster get-configuration <имя_или_идентификатор_кластера>
```
Пример конфигурационного файла
```
{
  auth_class = {
    module_name = "yc_managed_ytsaurus_auth";
    class_name = "IamTokenAuth";
  };
  proxy = {
    url = "https://proxy.<идентификатор_кластера_YTsaurus>.ytsaurus.yandexcloud.net";
    enable_proxy_discovery = %false;
  }
}
```
Конфигурационный файл будет сохранен по пути ~/.yt/config.

Идентификатор кластера можно запросить со списком кластеров в каталоге.
Выполните запрос списка содержимого корневого каталога:
```
yt list /
```

Python

Перед подключением:

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
Установите YTsaurus CLI по инструкции.

Установите зависимости:

sudo apt update && sudo apt install -y python3 python3-pip && \
pip3 install ytsaurus-client-yc-auth

Подключение с пользовательской ВМ

Подключение из интернета

Пример кода:

connect.py

import yt.wrapper as yt
from yc_managed_ytsaurus_auth import with_iam_token_auth

client = yt.YtClient(
    proxy="http://hp.<идентификатор_кластера_YTsaurus>.ytsaurus.mdb.yandexcloud.net:32100",
    config=with_iam_token_auth(
        config={"proxy": {"network_name": "external", "http_proxy_role": "default"}}
    ),
)

client.list("/")

Подключение:
```
python3 connect.py
```

Пример кода:

connect.py

import yt.wrapper as yt
from yc_managed_ytsaurus_auth import with_iam_token_auth

client = yt.YtClient(
    proxy="https://proxy.<идентификатор_кластера_YTsaurus>.ytsaurus.yandexcloud.net",
    config=with_iam_token_auth(config={"proxy": {"enable_proxy_discovery": False}}),
)

client.list("/")

Подключение:
```
python3 connect.py
```

Подключение к кластеру YTsaurus

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

BashBash

PythonPython

Была ли статья полезна?

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

Bash

Python