Creación de una tabla en Azure Cosmos DB for Table mediante .NET

SE APLICA A: Table

Las tablas de Azure Cosmos DB for Table son unidades de administración para varios elementos. Para poder crear o administrar elementos, primero debe crear una tabla.

Indicación de un nombre de tabla

En Azure Cosmos DB, una tabla es análoga a una tabla de una base de datos relacional.

Nota

Con las cuentas de API para Table, cuando crea su primera tabla, también se crea automáticamente una base de datos predeterminada dentro de su cuenta de Azure Cosmos DB.

Estas son algunas reglas rápidas de la asignación de un nombre a una tabla:

• Los nombres de tabla deben tener una longitud de entre 3 y 63 caracteres.
• Los nombres de tabla solo pueden contener letras en minúsculas, números y el carácter de guion (-).
• Los nombres de tabla deben empezar por una letra en minúsculas o un número.

Creación de una tabla

Para crear una tabla, llame a uno de los métodos siguientes:

• CreateAsync
• CreateIfNotExistsAsync

Creación asincrónica de una tabla

En el ejemplo siguiente se crea una tabla de forma asincrónica:

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

await tableClient1.CreateAsync();

El método TableCient.CreateAsync generará una excepción si ya existe una base de datos con el mismo nombre.

Creación de una tabla de forma asincrónica si no existe

En el ejemplo siguiente se crea una tabla de forma asincrónica solo si aún no existe en la cuenta:

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

await tableClient2.CreateIfNotExistsAsync();

El método TableClient.CreateIfNotExistsAsync solo creará una nueva tabla si aún no existe. Este método es útil para evitar errores si ejecuta el mismo código varias veces.

Pasos siguientes

Ahora que ha creado una tabla, use la siguiente guía para crear elementos.

Creación de un elemento