使用 .NET 在 Azure Cosmos DB for Table 中创建表

  • 项目

适用对象： 表

Azure Cosmos DB for Table 中的表是多个项的管理单元。 必须先创建表，然后才能创建或管理项。

命名表

在 Azure Cosmos DB 中，表类似于关系数据库中的表。

注意

如果使用 API for Table 帐户，在创建第一个表时，系统会自动在 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 方法仅在尚不存在某个表时才创建该新表。 如果多次运行同一代码，则此方法对于避免错误非常有用。

后续步骤

创建表后，请使用下一个指南来创建项。

创建项