Публикация записных книжек в коллекцию записных книжек Azure Cosmos DB

ОБЛАСТЬ ПРИМЕНЕНИЯ: API SQL

Встроенные записные книжки Jupyter Notebook в Azure Cosmos DB напрямую интегрируются с учетными записями Azure Cosmos DB на портале Azure. С помощью этих записных книжек можно анализировать и визуализировать данные из портала Azure. Встроенные записные книжки для Azure Cosmos DB сейчас доступны во многих регионах. Чтобы использовать записные книжки, создайте учетную запись Cosmos или включите записные книжки в существующую учетную запись в одном из поддерживаемых регионов.

В среде записной книжки на портале Azure есть несколько примеров, опубликованных командой Azure Cosmos DB. Она также содержит общедоступную коллекцию, в которой можно публиковать и совместно использовать свои записные книжки. После публикации записной книжки в коллекции она становится доступной всем пользователям Azure Cosmos DB для просмотра и использования. В этой статье вы узнаете, как использовать записные книжки из общедоступной коллекции и публиковать в ней свои записные книжки.

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

  1. Войдите на портал Azure и перейдите к своей учетной записи Azure Cosmos DB, которой разрешен доступ к среде записных книжек.

  2. Перейдите на вкладку Обозреватель данных>Записные книжки>Коллекция>Общедоступная коллекция.

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

    Navigate to the notebooks public gallery and accept the code of conduct.

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

    Download a notebook from the gallery to your workspace.

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

Выполните указанные ниже действия, чтобы опубликовать записную книжку.

  1. Войдите на портал Azure и перейдите к своей учетной записи Azure Cosmos DB, которой разрешен доступ к среде записных книжек.

  2. Перейдите на вкладку Обозреватель данных>Записные книжки>Мои записные книжки.

  3. Перейдите к записной книжке, которую необходимо опубликовать. Нажмите кнопку Сохранить на панели команд, а затем выберите Опубликовать в коллекции.

    Choose a notebook to publish to the gallery.

    Вариант Опубликовать в коллекции также можно найти, нажав кнопку рядом с именем записной книжки:

    Another approach to choose a notebook to publish to the gallery.

  4. Заполните форму Публикация в коллекции, указав следующие сведения.

    • Имя: понятное имя для идентификации записной книжки.
    • Описание: краткое описание назначения записной книжки.
    • Теги: теги являются необязательными и используются для фильтрации результатов при поиске по ключевому слову.
    • Изображение обложки: изображение, которое используется на обложке страницы при публикации записной книжки. Вы можете выбрать один из следующих вариантов:
    • Пользовательское изображение. Вы можете передать изображение со своего компьютера. Выберите файл изображения с пропорциями 256x144.
    • URL-адрес. Укажите общедоступный URL-адрес, по которому расположен образ.
    • Создание снимка экрана. Снимок экрана открытой записной книжки автоматически создается и передается для предварительного просмотра.
    • Использование первых отображаемых выходных данных. Вывод первой ячейки с отображаемыми выходными данными. Ячейки, в которых отображаются только разметка или текст, не рассматриваются как содержащие отображаемые выходные данные.

    Fill out the publish to gallery form.

    Примечание

    Если вы используете вариант Опубликовать в коллекции из меню рядом с именем записной книжки, вы не увидите все варианты Изображение обложки. Это связано с тем, что записная книжка может не быть открытой и Azure Cosmos DB не сможет сделать снимок экрана или получить доступ к первым отображаемым выходным данным.

  5. Убедитесь, что предварительный просмотр выглядит хорошо, и нажмите кнопку Опубликовать. После публикации записная книжка появится в общедоступной коллекции записных книжек Azure Cosmos DB. Перед публикацией убедитесь, что вся конфиденциальная информация или конфиденциальные выходные данные были удалены. Перед публикацией содержимое записной книжки сканируется на предмет нарушения политик Майкрософт. Обычно этот процесс занимает несколько секунд. При обнаружении каких-либо нарушений на вкладке уведомлений отображается сообщение. В случае обнаружения нарушения записная книжка не будет опубликована, пока вы не удалите текст, нарушающий политики, и не опубликуете ее снова.

    Примечание

    После публикации записных книжек в общедоступной коллекции их смогут просматривать все пользователи Azure Cosmos DB. Доступ не ограничивается на уровне подписки или организации.

  6. После публикации записной книжки в коллекции ее можно увидеть на вкладке Моя опубликованная работа. Опубликованные в общедоступной коллекции записные книжки также можно убрать из нее или удалить.

  7. Вы также можете сообщить о записной книжке, которая нарушает правила поведения. При обнаружении нарушения Cosmos DB автоматически удаляет записную книжку из коллекции. Если записная книжка будет удалена, пользователи смогут увидеть ее на вкладке Моя опубликованная работа с заметкой об удалении. Чтобы сообщить о записной книжке, перейдите на вкладку Обозреватель данных>Записные книжки>Коллекция>Общедоступная коллекция. Откройте нужную записную книжку, наведите указатель мыши на кнопку Справка в правом углу и выберите пункт Сообщить о нарушении.

    Report a notebook that violates the code of conduct.

Дальнейшие действия