Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
В этой статье вы узнаете, как переименовать таблицы и изменить схему таблицы, добавив, переименовав и удалив столбцы. В ней описываются последствия и зависимости изменений схемы таблицы для связанных объектов и сопоставлений.
Осторожность
- Существующие операции приёма данных, сопоставления приёма данных, политики обновления, функции, операции экспорта, материализованные представления и другие связанные операции могут завершиться ошибкой после изменения схемы таблицы. Ознакомьтесь с Зависимостями и убедитесь, что вы соответствующим образом изменили реализацию схем сопоставления при приёме данных, политик обновления, функций, экспорта и материализованных представлений.
Зависимости
Изменение схемы таблицы может привести к сбою приема и запроса из-за зависимостей, ссылающихся на имя таблицы или столбцы таблицы. В следующей матрице указываются последствия редактирования схемы.
| Изменение схемы | Зависимость |
|---|---|
| Переименование таблиц |
Материализованные представления: * По умолчанию все материализованные представления, которые напрямую ссылаются на старое имя таблицы, обновляются так, чтобы указывать на новое имя, в рамках транзакции. * Если имя таблицы используется в хранимой функции, вызываемой запросом представления, необходимо вручную обновить ссылку в материализованном представлении с помощью .alter materialized-view. |
| Переименование столбцов | * Переименование столбца автоматически обновляет все ссылки на него в сопоставлениях загрузки. * Переименование столбца сохраняет все текущие преобразования в ваших сопоставлениях. |
| Добавление столбцов | * Добавление нового столбца не приводит к автоматическому обновлению сопоставлений при приёме данных. Если требуется включить новый столбец, необходимо вручную обновить сопоставления.
* Изменение схемы не обновляет сопоставление входящих данных со столбцами таблицы во время загрузки. * После добавления столбцов убедитесь, что сопоставление обновлено, чтобы данные загружались правильно. Для получения дополнительной информации об обновлении сопоставления ингестии, см. команду .alter ingestion mapping |
| Тип столбца | Изменение типа столбца не поддерживается с помощью параметра "Изменить схему таблицы", так как изменение типа столбца приведет к потере данных. |
| Удаление столбцов | * Удаление столбца исключает его из всех карт приёма данных. * Эта операция необратима и приводит к потере данных. Невозможно запрашивать данные в удаленном столбце. * Осторожность Если удалить столбец, сохранить и добавить его еще раз, данные не восстанавливаются. Он ведет себя как новый столбец и сопоставления приема не обновляются. Необходимо вручную обновить сопоставления приема. |
Предпосылки
- Рабочая область с емкостью , поддерживающей Microsoft Fabric.
- База данных KQL с разрешениями на редактирование
- Изменения схемы таблицы не поддерживаются при активном подключении OneLake. Отключите доступность OneLake перед переименованием таблицы или редактированием столбцов таблицы. Его можно включить позже, а новая копия сохраняется в OneLake.
Переименование таблицы
При переименовании таблицы все ссылки на неё в сопоставлениях приема данных обновляются автоматически. В некоторых случаях необходимо вручную обновить сопоставления таблиц и ссылки. Перед переименованием таблицы просмотрите зависимости.
Перейдите к нужной базе данных KQL и в области обозревателя разверните таблицы.
Выберите таблицу из списка и откройте меню "Дополнительно" [...].
В окне "Изменение схемы таблицы " измените имя таблицы. При необходимости измените описание таблицы.
В разделе Зависимостей просмотрите ссылки на объекты.
По умолчанию включено автоматическое обновление материализованных представлений . Обновления команды можно просмотреть в средстве просмотра команд.
При необходимости отключите автоматическое обновление материализованных представлений. Убедитесь, что вы проверили влияние в разделе Зависимости и при необходимости вручную обновите сопоставление загрузки таблиц.
Нажмите кнопку "Обновить" и в окне подтверждения введите имя таблицы еще раз и выберите "Изменить схему таблицы".
Изменение столбцов таблицы
Если вы переименуете или добавите столбцы в таблицу, все ссылки на эту таблицу в сопоставлениях приема данных обновятся автоматически. В некоторых случаях необходимо вручную обновить сопоставления таблиц и ссылки. Перед изменением столбцов таблицы просмотрите зависимости.
Перейдите к нужной базе данных KQL. На панели обозревателя разверните Таблицы.
Выберите таблицу из списка и откройте меню "Дополнительно" [...].
Чтобы добавить новый столбец, введите имя столбца в нижней части списка столбцов. Имя столбца должно начинаться с буквы и может содержать числа, периоды, дефисы или символы подчеркивания.
Выберите тип данных для столбца. По умолчанию выбран тип столбца
string, но его можно изменить в раскрывающемся меню поля Тип столбца.Выберите Добавить столбец, чтобы добавить дополнительные столбцы.
В разделе Зависимостей просмотрите ссылки на объекты.
По умолчанию автоматическое обновление сопоставлений включено. Обновления команды сопоставления приема можно просмотреть в средстве просмотра команд.
При необходимости отключите автоматическое обновление сопоставлений. Убедитесь, что вы проверили влияние в разделе Зависимости и при необходимости вручную обновите сопоставление загрузки таблиц.
При необходимости обновите сопоставление приема данных.
Связанный контент
- Создайте пустую таблицу
- Прием данных: сопоставление