Импорт записных книжек из репозитория GitHub в Azure Cosmos DB

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

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

Получение записных книжек из GitHub

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

  1. Войдите на портал Azure и перейдите в учетную запись Azure Cosmos.

  2. Откройте вкладку Data Explorer. На этой вкладке отображаются все существующие базы данных, контейнеры и записные книжки.

  3. Выберите пункт меню Подключиться к GitHub.

  4. Откроется вкладка, где можно выбрать режим подключения: Общедоступные репозитории или Общедоступные и частные репозитории. Выбрав нужный вариант, щелкните Разрешить доступ. Авторизация требуется для того, чтобы служба Azure Cosmos DB получила доступ к репозиториям в вашей учетной записи GitHub.

    Authorize Azure Cosmos DB to access your GitHub repositories

  5. Вы будете перенаправлены на веб-страницу github.com, где можно подтвердить авторизацию. Нажмите кнопку Разрешить AzureCosmosDBNotebooks и введите пароль учетной записи GitHub в соответствующем приглашении.

  6. После успешной авторизации вы вернетесь к учетной записи Azure Cosmos. Теперь вы можете просмотреть все общедоступные и частные репозитории в учетной записи GitHub. Вы можете выбрать репозиторий в списке доступных или добавить репозиторий, используя его URL-адрес.

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

    Choose a repository and a branch

  8. Чтобы завершить операцию импорта, щелкните ОК. Все записные книжки, доступные в выбранной ветви репозитория, будут импортированы в учетную запись Azure Cosmos.

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

Чтобы отключить учетную запись GitHub от рабочей области записных книжек, откройте вкладку Data Explorer, щелкните рядом с элементом Репозитории GitHub и выберите Отключиться от GitHub.

Редактирование записной книжки и отправка изменений в GitHub

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

После изменения существующей записной книжки щелкните Сохранить. Откроется диалоговое окно, в котором можно написать сообщение о внесенных изменениях для фиксации. Щелкните Зафиксировать. Записная книжка обновится в GitHub. Вы можете проверить обновления, войдя в учетную запись GitHub и просмотрев журнал фиксаций.

В обычном потоке GitHub после фиксации изменений выполняется принудительная отправка изменений в удаленный репозиторий. Но в этом случае "фиксация" обозначает следующий набор действий: подготовка, фиксация и передача обновлений в GitHub.

Edit notebooks and commit changes to GitHub

После изменения записной книжки ее можно опубликовать в коллекции записных книжек.

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