Создание таблицы в Azure Cosmos DB для таблицы с помощью .NET

Статья
08/15/2024

Область применения: Таблица

Таблицы в Azure Cosmos DB для таблицы — это единицы управления для нескольких элементов. Прежде чем создавать элементы или управлять ими, необходимо сначала создать таблицу.

Присвоение имени таблице

Таблица в Azure Cosmos DB аналогична таблице в реляционной базе данных.

Примечание.

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

Ниже приведены краткие правила присвоения имени таблице.

Имена таблиц могут содержать от 3 до 63 символов.
Имена таблиц могут содержать только строчные буквы, цифры или дефис (-).
Имена таблиц должны начинаться со строчной буквы или цифры.

Создание таблицы

Для создания таблицы вызовите один из следующих методов:

CreateAsync
CreateIfNotExistsAsync

Асинхронное создание таблицы

Следующий пример демонстрирует асинхронное создание таблицы.

// New instance of TableClient class referencing the server-side table
TableClient tableClient1 = client.GetTableClient(
    tableName: "adventureworks-1"
);

await tableClient1.CreateAsync();

Метод TableCient.CreateAsync вызовет исключение, если база данных с таким именем уже существует.

Создайте таблицу асинхронно, если ее еще не существует.

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

// New instance of TableClient class referencing the server-side table
TableClient tableClient2 = client.GetTableClient(
    tableName: "adventureworks-2"
);

await tableClient2.CreateIfNotExistsAsync();

С помощью метода TableClient.CreateIfNotExistsAsync новая таблица будет создана только в том случае, если ее еще не существует. Этот метод полезен для предотвращения ошибок при многократном выполнении одного и того же кода.

Следующие шаги

Теперь, когда таблица создана, воспользуйтесь следующим руководством для создания элементов.

Создание элемента

Поделиться через