Руководство по Совместное использование Пространственных привязок Azure между сеансами и устройствами с помощью серверной части службы Azure Cosmos DBTutorial: Sharing Azure Spatial Anchors across sessions and devices with an Azure Cosmos DB back end

Это руководство является продолжением руководства по совместному использованию Пространственных привязок Azure между сеансами и устройствами.This tutorial is a continuation of sharing Azure Spatial Anchors across sessions and devices. С его помощью вы добавите еще несколько возможностей, чтобы использовать Azure Cosmos DB в качестве серверного хранилища при совместном использовании Пространственных привязок Azure для сеансов и устройств.It will guide you through the process of adding a few more capabilities to make Azure Cosmos DB serve as the back-end storage while sharing Azure spatial anchors across sessions and devices.

GIF, иллюстрирующий сохраняемость объектов

Хотя в этом учебнике рассматриваются Unity и Azure Cosmos DB, они представлены лишь в качестве примера того, как можно совместно использовать идентификаторы Пространственных привязок на разных устройствах.It's worth noting that, though you'll be using Unity and Azure Cosmos DB in this tutorial, it's just to give you an example of how to share Spatial Anchors identifiers across devices. Вы можете использовать другие языки и серверные технологии в тех же целях.You can user other languages and back-end technologies to achieve the same goal.

Создание учетной записи базы данныхCreate a database account

Добавьте базу данных Azure Cosmos в созданную ранее группу ресурсов.Add an Azure Cosmos Database to the resource group you created earlier.

  1. В новом окне браузера войдите на портал Azure.In a new browser window, sign in to the Azure portal.

  2. В меню слева выберите Создать ресурс.In the left menu, select Create a resource.

    Создание ресурса на портале Azure

  3. На странице New (Новый) выберите Базы данных > Azure Cosmos DB.On the New page, select Databases > Azure Cosmos DB.

    Область Базы данных на портале Azure

  4. На странице Создание учетной записи Azure Cosmos DB введите параметры для новой учетной записи Azure Cosmos DB.On the Create Azure Cosmos DB Account page, enter the settings for the new Azure Cosmos DB account.

    ПараметрSetting ЗначениеValue ОписаниеDescription
    ПодпискаSubscription Ваша подпискаYour subscription Вы подписку Azure, которую нужно использовать для этой учетной записи Azure Cosmos DB.Select the Azure subscription that you want to use for this Azure Cosmos DB account.
    Группа ресурсовResource Group Щелкните Создать, а затем введите имя учетной записи.Create new, then Account Name Выберите Создать.Select Create new. Затем введите новое имя группы ресурсов для учетной записи.Then enter a new resource group name for your account. Для удобства можно использовать то же имя, которое присвоено учетной записи Azure Cosmos DB.For simplicity, use the same name as your Azure Cosmos DB account name.
    Имя учетной записиAccount Name Уникальное имяA unique name Введите уникальное имя для идентификации вашей учетной записи Azure Cosmos DB.Enter a unique name to identify your Azure Cosmos DB account.

    Имя может содержать только строчные буквы, цифры и дефисы. Его длина должна быть от 3 до 31 знаков.The account name can use only lowercase letters, numbers, and hyphens (-), and must be between 3 and 31 characters long.
    APIAPI ТаблицаTable API определяет тип учетной записи, которую нужно создать.The API determines the type of account to create. Azure Cosmos DB предоставляет пять API: API Core (SQL) для баз данных документов, API Gremlin для графовых баз данных, API MongoDB для баз данных документов, API таблиц Azure и API Cassandra.Azure Cosmos DB provides five APIs: Core (SQL) for document databases, Gremlin for graph databases, MongoDB for document databases, Azure Table, and Cassandra. Для каждого API требуется создать отдельную учетную запись.You must create a separate account for each API.

    Выберите Таблица Azure, так как в этом кратком руководстве создается таблица, которая работает с API таблиц.Select Azure Table, because in this quickstart you are creating a table that works with the Table API.

    Подробные сведения об API таблиц.Learn more about the Table API.
    РасположениеLocation Ближайший к пользователям регионThe region closest to your users Выберите географическое расположение для размещения учетной записи Azure Cosmos DB.Select a geographic location to host your Azure Cosmos DB account. Используйте ближайшее к пользователям расположение, чтобы предоставить им максимально быстрый доступ к данным.Use the location that's closest to your users to give them the fastest access to the data.

    Вы можете не изменять значения по умолчанию для параметров Геоизбыточность и Записи в нескольких регионах (Отключить), чтобы избежать дополнительных затрат, и пропустить разделы Сеть и Теги.You can leave the Geo-Redundancy and Multi-region Writes options at Disable to avoid additional charges, and skip the Network and Tags sections.

  5. Выберите Просмотр и создание.Select Review+Create. После завершения проверки нажмите Создать, чтобы создать учетную запись.After the validation is complete, select Create to create the account.

    Страница Новая учетная запись для Azure Cosmos DB

  6. Создание учетной записи занимает несколько минут.It takes a few minutes to create the account. Вы увидите сообщение Развертывание выполняется.You'll see a message that states Your deployment is underway. Дождитесь завершения развертывания, а затем нажмите кнопку Перейти к ресурсу.Wait for the deployment to finish, and then select Go to resource.

    Область Уведомления на портале Azure

Скопируйте Connection String, так как она потребуется вам.Copy the Connection String because you'll need it.

Внесение незначительных изменений в файлы SharingServiceMake minor changes to the SharingService files

Откройте SharingService\Startup.cs в обозревателе решений.In Solution Explorer, open SharingService\Startup.cs.

Найдите строку #define INMEMORY_DEMO в верхней части файла и закомментируйте ее. Сохраните файл.Locate #define INMEMORY_DEMO at the top of the file and comment that line out. Save the file.

Откройте SharingService\appsettings.json в обозревателе решений.In Solution Explorer, open SharingService\appsettings.json.

Найдите свойство StorageConnectionString и введите для него значение, совпадающее со значением Connection String, которое вы скопировали на шаге создания учетной записи для базы данных.Locate the StorageConnectionString property, and set the value to be the same as the Connection String value that you copied in the create a database account step. Сохраните файл.Save the file.

SharingService можно опубликовать еще раз и запустить пример приложения.You can publish the Sharing Service again and run the sample app.

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

В этом руководстве вы обеспечили совместное использование идентификаторов привязок между устройствами с помощью Azure Cosmos DB.In this tutorial, you've used Azure Cosmos DB to share anchor identifiers across devices. Чтобы узнать больше об использовании Пространственных привязок Azure в новом приложении Unity HoloLens, перейдите к следующему учебнику.To learn more about how to use Azure Spatial Anchors in a new Unity HoloLens app, continue to the next tutorial.