Добавление комментариев к данным и ресурсам ИИ

В этой статье приводятся комментарии к данным и ресурсам ИИ и объясняется, как их добавить. Комментарии помогут вам и другим пользователям найти нужные данные и ресурсы ИИ и управлять ими.

Примечания предоставляют поле метаданных для аннотирования защищаемых объектов. Комментарии можно добавлять в любой защищаемый объект в каталоге Unity, например каталоги, схемы, таблицы, тома, модели ИИ и многое другое. Вы также можете добавлять примечания в столбцы таблицы.

Вы можете добавить комментарии вручную или позволить Databricks создавать созданные ИИ комментарии. Созданные ИИ комментарии (также известные как документация по искусственному интеллекту) доступны для таблиц и столбцов таблиц. См. сведения о добавлении примечаний, созданных ИИ, в объекты каталога Unity.

При изменении примечаний для таблицы каталога Unity (или таблицы Delta Lake в устаревшем хранилище метаданных Hive) SET TBLPROPERTIES операция в журнале таблиц записывает SQL-запрос, используемый для определения комментария таблицы.

Подготовка к работе

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

• Чтобы добавить или изменить примечания к каталогу, схеме, тому, модели, общей папке, получателю, поставщику, учетным данным хранилища, внешнему расположению или подключению, необходимо быть владельцем объекта или иметь привилегии MANAGE для объекта.
• Чтобы добавить или изменить комментарии в таблице или столбце, необходимо быть владельцем или иметь следующие права:
  • MODIFY и SELECT на столе.
  • USE CATALOG в USE SCHEMA родительском каталоге и схеме.
• Необходимо использовать хранилище SQL или другие вычислительные ресурсы, поддерживающие каталог Unity (общие или однопользовательские вычисления).
• Чтобы использовать комментарии, созданные ИИ, рабочая область должна быть включена для функций, поддерживающих ИИ. См. сведения о добавлении примечаний, созданных ИИ, в объекты каталога Unity.

Добавление и изменение комментариев

Вы можете добавлять примечания к защищаемым объектам или изменять их с помощью команд SQL или обозревателя каталогов.

Обозреватель каталогов

1. На боковой панели рабочей области щелкните "Каталог ", чтобы открыть обозреватель каталогов.

2. Найдите и выберите объект, который вы хотите комментировать.

   Объекты данных и ИИ перечислены и доступны для поиска в области каталога . Общие папки, учетные данные хранения, внешние расположения и подключения доступны с помощью меню, которое открывается при щелчке значка шестеренки .

3. Добавьте комментарий или измените существующий комментарий.

   • Чтобы добавить комментарий в таблицу с помощью примечаний, созданных СИ, просмотрите предложенный ИИ комментарий на правой панели вкладки "Обзор ". Может потребоваться несколько секунд. Примите его как есть или измените и сохраните его.
   • Чтобы добавить комментарий в столбец таблицы с помощью комментариев, созданных СИ, нажмите кнопку создания ИИ над списком столбцов. Databricks создает комментарии для каждого столбца. Примите их как есть или измените их. Щелкните флажок, чтобы сохранить комментарий.
   • Чтобы добавить комментарий к объекту, который не поддерживает созданные ИИ комментарии, нажмите кнопку "Добавить комментарий", чтобы добавить комментарий .
   • Чтобы добавить комментарий в столбец таблицы без использования примечаний, созданных СИ, щелкните значок "Добавить комментарий" в строке столбца.
   • Если комментарий уже существует, он отображается на правой панели на вкладке "Обзор " или под именем объекта. Если он не создан ИИ, щелкните значок редактирования, чтобы изменить его.

В пользовательском интерфейсе обозревателя каталогов можно использовать базовую разметку Markdown. Стилизация Markdown не отображается при возврате операторами DESCRIBE . Весь базовый синтаксис поддерживается в обозревателе каталогов, кроме изображений, и отрисовываются только два уровня заголовков. Дополнительные сведения см. в разделе "Базовый синтаксис".

Дополнительные сведения о комментариях, созданных СИ, см. в разделе "Добавление примечаний, созданных ИИ" в объекты каталога Unity.

SQL

С помощью команды SQL можно добавить строковый литерал в качестве комментария к любому защищаемому объекту в каталоге Unity и таблицам, управляемым в устаревшем хранилище метаданных Hive. Используемая команда SQL зависит от объекта, для которого требуется добавить или изменить комментарий:

• Чтобы добавить или обновить комментарий для любого существующего защищаемого объекта, кроме столбцов таблицы, используйте COMMENT ON команду. См. ПРИМЕЧАНИЕ.

  Можно также использовать COMMENT параметр с командой ALTER <object> для объекта (например, ALTER TABLE). См. справочную статью ПО SQL для ALTER <object> команды.

• Чтобы добавить или обновить комментарий столбца для существующей таблицы, используйте ALTER TABLE команду с ALTER COLUMN предложением и COMMENT параметром в столбце. См. статью ALTER TABLE и ALTER TABLE ... Предложение COLUMN.

• Чтобы добавить комментарий при создании объекта, используйте COMMENT параметр с командой CREATE <object> . См. справочную статью ПО SQL для CREATE <object> команды, которую вы хотите использовать.