Поделиться через

Изменение схемы таблицы

В этой статье вы узнаете, как переименовать таблицы и изменить схему таблицы, добавив, переименовав и удалив столбцы. Описываются последствия и зависимости изменений схемы таблицы от ссылочных объектов и сопоставлений.

Осторожность

  • Существующие загрузки, сопоставления загрузок, политики обновления, функции, экспорт, материализованные представления и другие связанные операции могут завершиться сбоем после редактирования схемы таблицы. Ознакомьтесь с зависимостями и уточните, что вы редактируете реализацию сопоставлений приема, обновляете политики, функции, экспорт и материализованные представления соответствующим образом.

Зависимости

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

Изменение схемы Зависимость
Переименование таблиц Материализованные представления:
* По умолчанию все материализованные представления, ссылающиеся на старое имя таблицы, обновляются напрямую, чтобы указать новое имя в транзакционной форме.
* Если имя таблицы ссылается из хранимой функции, вызываемой запросом представления, необходимо обновить материализованную ссылку на представление вручную с помощью alter materialized-view.
Переименование столбцов * Переименование столбца автоматически обновляет все ссылки на него в сопоставлениях загрузки.
* Переименование столбца сохраняет все текущие преобразования в ваших сопоставлениях.
Добавление столбцов * Добавление нового столбца не обновляет сопоставления данных при получении автоматически. Если требуется включить новый столбец, необходимо вручную обновить сопоставления.
* Изменение схемы не обновляет сопоставление входящих данных со столбцами таблицы во время загрузки.
* После добавления столбцов убедитесь, что сопоставление обновлено, чтобы данные загружались правильно.
Для получения дополнительной информации об обновлении сопоставления ингестии, см. команду .alter ingestion mapping
Тип столбца Изменение типа столбца не поддерживается с помощью параметра "Изменить схему таблицы", так как изменение типа столбца приведет к потере данных.
Удаление столбцов * Удаление столбца исключает его из всех карт приёма данных.
* Эта операция необратима и приводит к потере данных. Невозможно запрашивать данные в удаленном столбце.
* Осторожность Если удалить столбец, сохранить и добавить его еще раз, данные не восстанавливаются. Он ведет себя как новый столбец и сопоставления приема не обновляются. Вам потребуется вручную обновить сопоставления приема.

Предпосылки

Переименование таблицы

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

  1. Перейдите к нужной базе данных KQL и в области обозревателя разверните таблицы.

  2. Выберите таблицу из списка и откройте меню "Дополнительно" [...].

    Снимок экрана: меню

  3. В окне "Изменение схемы таблицы " измените имя таблицы. При необходимости измените описание таблицы.

    Снимок экрана: изменение схемы таблицы с выделенным полем имени таблицы.

  4. В разделе Зависимостей просмотрите ссылки на объекты.

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

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

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

  5. Нажмите кнопку "Обновить" и в окне подтверждения введите имя таблицы еще раз и выберите "Изменить схему таблицы".

    Снимок экрана: окно подтверждения с выделенным полем имени таблицы.

Изменение столбцов таблицы

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

  1. Перейдите к нужной базе данных KQL и в области обозревателя разверните таблицы.

  2. Выберите таблицу из списка и откройте меню "Дополнительно" [...].

    Снимок экрана: меню

  3. Чтобы добавить новый столбец, введите имя столбца в нижней части списка столбцов. Имя столбца должно начинаться с буквы и может содержать числа, периоды, дефисы или символы подчеркивания.

  4. Выберите тип данных для столбца. Тип столбца по умолчанию string, но может быть изменен в раскрывающемся меню типа столбца .

  5. Выберите Добавить столбец, чтобы добавить дополнительные столбцы.

  6. В разделе Зависимостей просмотрите ссылки на объекты.

    • По умолчанию автоматическое обновление сопоставлений включено. Обновления команды сопоставления приема можно просмотреть в средстве просмотра команд.

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

    Снимок экрана: средство просмотра команд с сопоставлениями автоматического обновления, включенными в разделе зависимостей.

  7. При необходимости обновите сопоставление приема данных.

Связанный контент