Добавление и настройка таблицLTS

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

Для создания новой таблицы нажмите + Добавить таблицу → Создать.

Импорт таблицы

Чтобы импортировать таблицу из локального расположения, выберите пункт Импортировать.

Файл обязательно должен содержать заголовок. В конце файла не должно быть пустых строк.

При загрузке таблицы задайте:

• Разделитель (; — точка с запятой, , — запятая, | — прямая черта, / — косая черта, табуляция, пробел или другое)
• Квалификатор (' — одинарные кавычки или " — двойные кавычки)
• Кодировку (UTF-8, UTF-8 BOM или Windows-1251)

Тип данных для колонок с массивами

Значения в квадратных скобках [] не распознаются как массивы при импорте. Чтобы колонка обрабатывалась как массив, в окне предпросмотра импортируемой таблицы нажмите на тип данных колонки. Вручную удалите указанное значение и введите: Array(String).

Если значения в колонке ранее добавленной таблицы изменились на массивы:

1. В Модели данных выберите эту таблицу.
2. В консоли снизу нажмите иконку контекстного меню нужной колонки.
3. Выберите Редактировать.
4. В поле Тип данных укажите Array(String) и нажмите Сохранить.

Создание новой таблицы

При создании новой таблицы открывается модальное окно, в котором можно задать:

• Название таблицы
• Названия колонок и тип данных
• Партиционирование
• Сортировку

При заполнении полей Партиционирование и Сортировка соблюдайте следующие требования:

• Используйте синтаксис ClickHouse
• Если в названии колонки есть кириллические символы или оно состоит из нескольких слов, то заключайте название в грависы. Пример: `колонка` или `column number one`
• Чтобы указать несколько колонок для партиционирования или сортировки, заключите их названия в круглые скобки. Пример: (`колонка`, `column number one`)

При дублировании, экспорте и импорте пространства значения, указанные в полях Партиционирование и Сортировка, сохраняются.

Создание таблицы доступно при выполнении условий:

• Задано название таблицы
• В таблице есть хотя бы одна колонка, для которой определены название и тип данных

Подробнее о типах данных можно прочитать на странице Редактирование скрипта.

Чтобы поменять колонки местами при создании таблицы, наведите курсор на иконку перемещения, кликните и, удерживая, переместите колонку на нужное место.

Как создаются таблицы можно посмотреть в видеокурсе.

Подключение таблицы из хранилища

Таблицы в пространство подключаются из базы данных ClickHouse, сервер которой добавлен в разделе Хранилища данных. Чтобы добавить таблицу, нажмите на пункт Подключить. Если в ClickHouse есть таблицы, появится модальное окно с их списком. Невозможно добавить повторно таблицы, которые уже подключены к пространству.

Выберите нужную и в режиме предпросмотра таблицы нажмите Подключить.

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

Просмотр таблицы

Чтобы посмотреть содержание таблицы, нажмите на нее. Снизу откроется консоль.

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

Хранение системных таблиц

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

Действия с таблицами

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

• Экспортировать в форматах (в кодировке UTF-8):
  • .csv
  • .xls
  • .xlsx
• Заменить
• Отключить
• Удалить

Также действия доступны в консоли, которая открывается по клику по таблице.

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

В открывшемся боковом окне можно изменить название таблицы, отредактировать имеющиеся колонки и добавить новые с помощью кнопки + Добавить колонку.

Чтобы сохранить изменения, нажмите кнопку Сохранить.

Чтобы внести изменения в конкретную колонку, выполните следующие действия:

1. Нажмите кнопку с тремя точками, которая расположена рядом с названием колонки.
2. В появившемся контекстном меню нажмите Редактировать.
3. Внесите необходимые изменения. Можно:
   • Изменить название
   • Изменить тип данных
   • Изменить свойство колонки на Nullable и обратно
   • Добавить описание колонки
4. Сохраните изменения, нажав Сохранить.

Если при изменении тип данных одной колонки не совпадает с типом данных второй колонки, выводится сообщение об этом и происходит возврат к предыдущему типу данных.

Чтобы удалить колонку, нажмите соответствующую кнопку в контекстном меню.

При помощи API можно:

• Добавлять таблицы в пространство
• Дозагружать данные в таблицы, не изменяя структуру
• Выгружать данные из базы данных
• Удалять таблицы из пространств