Создание таблицы в Azure Cosmos DB для таблицы с помощью .NET
Область применения: Таблица
Таблицы в Azure Cosmos DB для таблицы — это единицы управления для нескольких элементов. Прежде чем создавать элементы или управлять ими, необходимо сначала создать таблицу.
Присвоение имени таблице
Таблица в Azure Cosmos DB аналогична таблице в реляционной базе данных.
Примечание.
С помощью API для учетных записей таблиц при создании первой таблицы база данных по умолчанию автоматически создается в учетной записи Azure Cosmos DB.
Ниже приведены краткие правила присвоения имени таблице.
- Имена таблиц могут содержать от 3 до 63 символов.
- Имена таблиц могут содержать только строчные буквы, цифры или дефис (-).
- Имена таблиц должны начинаться со строчной буквы или цифры.
Создание таблицы
Для создания таблицы вызовите один из следующих методов:
Асинхронное создание таблицы
Следующий пример демонстрирует асинхронное создание таблицы.
// 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
новая таблица будет создана только в том случае, если ее еще не существует. Этот метод полезен для предотвращения ошибок при многократном выполнении одного и того же кода.
Следующие шаги
Теперь, когда таблица создана, воспользуйтесь следующим руководством для создания элементов.