你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

适用对象： 表

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

命名表

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

注意

如果使用 API for Table 帐户，在创建第一个表时，系统会自动在 Azure Cosmos DB 帐户中创建默认数据库。

创建表

若要创建表，请调用以下方法之一：

• 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 方法仅在尚不存在某个表时才创建该新表。 如果多次运行同一代码，则此方法对于避免错误非常有用。

后续步骤

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

创建项