Настройка TiDB

Плагин, поддерживаемый поставщиком

Некоторая основная функциональность может быть ограничена. Если вы заинтересованы в участии, ознакомьтесь с репозиторием исходного кода, указанным ниже.

• Поддерживается: PingCAP
• Авторы: Xiang Zhang, Qiang Wu, Yuhang Shi
• Репозиторий GitHub: pingcap/dbt-tidb
• Пакет PyPI: dbt-tidb
• Канал в Slack: #db-tidb
• Поддерживаемая версия dbt Core: v1.0.0 и новее
• Поддержка dbt: Не поддерживается
• Минимальная версия платформы данных: n/a

Установка dbt-tidb

Установите адаптер с помощью pip. До версии 1.8 установка адаптера автоматически устанавливала dbt-core и любые дополнительные зависимости. Начиная с 1.8 установка адаптера не устанавливает dbt-core автоматически. Это потому, что версии адаптеров и dbt Core были развязаны, и мы больше не хотим перезаписывать существующие установки dbt-core. Используйте следующую команду для установки:

python -m pip install dbt-core dbt-tidb

Настройка dbt-tidb

Конфигурацию, специфичную для TiDB, см. на странице настроек TiDB.

Подключение к TiDB с помощью dbt-tidb

Аутентификация с использованием имени пользователя и пароля

Настройте ваш профиль dbt для использования TiDB:

Профиль подключения к TiDB

profiles.yml

dbt-tidb:
  target: dev
  outputs:
    dev:
      type: tidb
      server: 127.0.0.1
      port: 4000
      schema: database_name
      username: tidb_username
      password: tidb_password

      # необязательно
      retries: 3 # по умолчанию 1

Описание полей профиля

Опция	Описание	Обязательно?	Пример
type	Конкретный адаптер для использования	Обязательно	tidb
server	Сервер (имя хоста) для подключения	Обязательно	yourorg.tidb.com
port	Порт для использования	Обязательно	4000
schema	Укажите схему (базу данных) для построения моделей	Обязательно	analytics
username	Имя пользователя для подключения к серверу	Обязательно	dbt_admin
password	Пароль для аутентификации на сервере	Обязательно	awesome_password
retries	Количество попыток после неудачного подключения	Необязательно	по умолчанию 1

Loading table...

Привилегии пользователя базы данных

Ваш пользователь базы данных должен иметь некоторые возможности для чтения или записи, такие как SELECT, CREATE и так далее. Вы можете найти помощь здесь по управлению привилегиями TiDB.

Необходимая привилегия
SELECT
CREATE
CREATE TEMPORARY TABLE
CREATE VIEW
INSERT
DROP
SHOW DATABASE
SHOW VIEW
SUPER

Loading table...

Поддерживаемые функции

TiDB 4.X	TiDB 5.0 ~ 5.2	TiDB >= 5.3	Функция
✅	✅	✅	Материализация таблиц
✅	✅	✅	Материализация представлений
❌	❌	✅	Инкрементальная материализация
❌	✅	✅	Эфемерная материализация
✅	✅	✅	Seeds
✅	✅	✅	Sources
✅	✅	✅	Пользовательские тесты данных
✅	✅	✅	Генерация документации
❌	❌	✅	Снимки
✅	✅	✅	Grant
✅	✅	✅	Повторное подключение

Loading table...

Примечание:

• TiDB 4.0 ~ 5.0 не поддерживает CTE, вам следует избегать использования WITH в вашем SQL-коде.
• TiDB 4.0 ~ 5.2 не поддерживает создание временной таблицы или представления.
• TiDB 4.X не поддерживает использование SQL-функций в CREATE VIEW, избегайте этого в вашем SQL-коде. Более подробную информацию можно найти здесь.

Нашли ошибку?

Создать GitHub Issue