Краткое руководство. Создание приложения Cassandra с помощью пакета SDK для. NET и Azure Cosmos DB

МУЖ БРОСИТ ПИТЬ НАВСЕГДА, ПРОСТО ДАЙТЕ ЕМУ ЭТО...
7 часов назад
КАК СБРОСИТЬ ОКОВЫ ЛИШНЕГО ВЕСА НАВСЕГДА
8 часов назад

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

В этом руководстве показано, как использовать .NET и API Cassandra в Azure Cosmos DB для создания приложения профиля путем клонирования примера с сайта GitHub. Кроме того, здесь показано, как создать учетную запись Azure Cosmos DB на веб-портале Azure.

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

Предварительные требования

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу. Кроме того, можно воспользоваться бесплатной пробной версией Azure Cosmos DB без подписки Azure, оплаты и каких-либо обязательств.

Кроме того, вам потребуется:

  • Visual Studio последней версии с рабочей нагрузкой разработки для Azure. Вы можете начать с бесплатного выпускаинтегрированной среды разработки Visual Studio Community. При установке Visual Studio включите рабочую нагрузку разработки для Azure.
  • Установите Git, чтобы клонировать пример.

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

На домашней странице или в меню портала Azure выберите Создать ресурс.

На странице Создание найдите и выберите Azure Cosmos DB.

На странице Azure Cosmos DB выберите Создать.

На странице создания учетной записи Azure Cosmos DB введите основные параметры для новой учетной записи Azure Cosmos.

Выберите Cassandra, так как в рамках этого краткого руководства вы создадите таблицу, которая работает с API Cassandra.

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

Страница

На вкладке Глобальное распределение настройте следующие сведения. При работе с этим кратким руководством можно оставить значения по умолчанию.

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

Следующие параметры недоступны, если вы выбрали значение Бессерверный для параметра Режим емкости:

  • Применение скидки на основе категории «Бесплатный»
  • Геоизбыточность
  • Выполнение операций записи в нескольких регионах

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

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

Выберите Review + create (Просмотреть и создать).

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

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

Выберите Перейти к ресурсу, чтобы перейти на страницу учетной записи Azure Cosmos DB.

Клонирование примера приложения

Теперь перейдем к работе с кодом. Давайте клонируем приложение API Cassandra с GitHub, зададим строку подключения и выполним ее. Вы узнаете, как можно упростить работу с данными программным способом.

Откройте командную строку. Создайте папку с именем git-samples . Затем закройте командную строку.

Откройте окно терминала git, например git bash, и выполните команду cd , чтобы перейти в новую папку для установки примера приложения.

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

Затем откройте файл решения CassandraQuickStartSample в Visual Studio.

Просмотр кода

Это необязательный шаг. Если вы хотите узнать, как создавать ресурсы базы данных в коде, изучите приведенные ниже фрагменты кода. Фрагменты кода взяты из файла Program.cs , установленного в папке C:\git-samples\azure-cosmos-db-cassandra-dotnet-getting-started\CassandraQuickStartSample . Если вас это не интересует, можете сразу переходить к разделу Обновление строки подключения.

Инициализируйте сеанс путем подключения к конечной точке кластера Cassandra. API-интерфейс Cassandra в Azure Cosmos DB поддерживает только TLS версии 1.2.

Создайте пространство ключей.

Вставьте пользовательские сущности, используя объект IMapper с новым сеансом, который подключается к пространству ключей uprofile.

Выполните запрос на получение информации обо всех пользователях.

Выполните запрос на получение информации об одном пользователе.

Обновление строки подключения

Теперь вернитесь на портал Azure, чтобы получить данные строки подключения. Скопируйте эти данные в приложение. Информация из строки подключения обеспечивает обмен данными между приложением и размещенной базой данных.

На портале Azure выберите Строка подключения.

МУЖ БРОСИТ ПИТЬ НАВСЕГДА, ПРОСТО ДАЙТЕ ЕМУ ЭТО...
6 часов назад
UNTOXIC УНИЧТОЖАЕТ ПАРАЗИТОВ И ВОССТАНАВЛИВАЕТ ОРГАНИЗМ
6 часов назад

Используйте кнопку в правой части экрана, чтобы скопировать значение параметра USERNAME.

Просмотр и копирование ключа доступа на странице Строка подключения на портале Azure

В Visual Studio откройте файл Program.cs.

Вставьте полученное на портале значение USERNAME вместо элемента в строке 13.

Теперь строка 13 в файле Program.cs будет выглядеть примерно так:

private const string UserName = «cosmos-db-quickstart»;

Вернитесь на портал и скопируйте значение PASSWORD. Вставьте полученное на портале значение PASSWORD вместо элемента в строке 14.

Теперь строка 14 в файле Program.cs будет выглядеть примерно так:

private const string Password = «2Ggkr662ifxz2Mg. ==»;

Вернитесь на портал и скопируйте значение CONTACT POINT (Точка контакта). Вставьте полученное на портале значение параметра CONTACT POINT над элементом в строке 15.

Теперь строка 15 в файле Program.cs будет выглядеть примерно так:

private const string CassandraContactPoint = «cosmos-db-quickstarts.cassandra.cosmosdb.azure.com»; // DnsName

Сохраните файл Program.cs.

Запустите приложение .NET.

В Visual Studio выберите Сервис>Диспетчер пакетов NuGet>Консоль диспетчера пакетов.

В командной строке введите указанную ниже команду, чтобы установить пакет NuGet драйвера .NET.

Нажмите клавиши CTRL + F5 для запуска приложения. Приложение откроется в окне консоли.

Просмотр и проверка выходных данных

Нажмите клавиши CTRL+C, чтобы остановить выполнение программы и закрыть окно консоли.

На портале Azure откройте обозреватель данных, чтобы запросить, изменить и обработать новые данные.

Просмотр данных в обозревателе данных

Просмотр соглашений об уровне обслуживания на портале Azure

На портале Azure можно отслеживать пропускную способность, объем хранилища, доступность, задержку и согласованность учетной записи Cosmos DB. На диаграммах метрик, связанных с соглашением об уровне обслуживания для Azure Cosmos DB, отображается значение, указанное в соглашении об уровне обслуживания, в сравнении с фактической производительностью. Этот набор метрик обеспечивает прозрачный мониторинг выполнения соглашения об уровне обслуживания.

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

Выберите Метрики в меню навигации учетной записи Cosmos DB.

Выберите вкладку, например Задержка, и укажите временной интервал справа. Сравните на диаграмме строки Actual (Фактическое значение) и SLA (Соглашение об уровне обслуживания).

Набор метрик Azure Cosmos DB

Просмотрите метрики на других вкладках.

Очистка ресурсов

После завершения работы с приложением и учетной записью Azure Cosmos DB можно удалить созданные ресурсы Azure, чтобы избежать дополнительных расходов. Удаление ресурсов:

На панели поиска портала Azure найдите и выберите Группы ресурсов.

Выберите из списка группу ресурсов, созданную для этого краткого руководства.

Выбор удаляемой группы ресурсов

На странице обзора группы ресурсов выберите Удалить группу ресурсов.

удаление группы ресурсов.

В следующем окне введите имя группы ресурсов, которую требуется удалить, и щелкните Удалить.

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

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

ЭФФЕКТИВНОЕ И БЕЗОПАСНОЕ УДАЛЕНИЕ ЛЮБЫХ ПЯТЕН
9 часов назад
НИКОГДА ЕЩЕ НЕ ВИДЕЛА СВОЮ КОЖУ ТАКОЙ СИЯЮЩЕЙ, КАК ПОСЛЕ...
9 часов назад

Читайте также