Compartir a través de


Creación de contenedores con una clave de partición de gran tamaño

SE APLICA A: NoSQL

Azure Cosmos DB usa el esquema de partición basado en hash para lograr el escalado horizontal de los datos. Todos los contenedores de Azure Cosmos DB creados antes del 3 de mayo de 2019 usan una función hash que calcula el hash en función de los primeros 101 bytes de la clave de partición. Si hay varias claves de partición con los mismos 101 primeros bytes, el servicio considera que esas particiones lógicas son la misma partición lógica. Esto puede provocar problemas, como que la cuota de tamaño de la partición sea incorrecta, que los índices únicos se apliquen incorrectamente en las claves de partición y que el almacenamiento se distribuya de forma desigual. Para solucionar este problema, aparecieron las claves de partición de gran tamaño. Azure Cosmos DB ahora admite claves de partición de gran tamaño con valores hasta 2 KB.

Las claves de partición de gran tamaño se admiten mediante el uso de una versión mejorada de la función hash, que puede generar un hash único a partir de claves de partición de gran tamaño, de hasta 2 KB. Como procedimiento recomendado, a menos que necesite soporte para un SDK o una aplicación de Azure Cosmos DB antiguo que no admita esta característica, siempre se recomienda configurar el contenedor con compatibilidad con claves de partición grandes.

Creación de una clave de partición de gran tamaño (Azure Portal)

Los contenedores creados mediante Azure Portal usan una clave de partición grande de forma predeterminada.

Creación de una clave de partición de gran tamaño (PowerShell)

Para crear un contenedor con soporte de clave de partición grande, consulte,

Creación de una clave de partición de gran tamaño (SDK de .NET)

Para crear un contenedor con una clave de partición de gran tamaño mediante el SDK de .NET, especifique la propiedad PartitionKeyDefinitionVersion.V2. En el ejemplo siguiente se muestra cómo especificar la propiedad de versión dentro del objeto PartitionKeyDefinition y establecerla en PartitionKeyDefinitionVersion.V2.

Nota:

De forma predeterminada, todos los contenedores creados con el SDK V2 de .NET no admiten claves de partición de gran tamaño. De forma predeterminada, todos los contenedores creados con el SDK V3 de .NET admiten claves de partición de gran tamaño.

await database.CreateContainerAsync(
    new ContainerProperties(collectionName, $"/longpartitionkey")
    {
        PartitionKeyDefinitionVersion = PartitionKeyDefinitionVersion.V2,
    })

Versiones de SDK compatibles

Las claves de partición de gran tamaño se admiten con las siguientes versiones mínimas de SDK:

Tipo de SDK Versión mínima
.NET 1.18
Java Sync 2.4.0
Java Async 2.5.0
API DE REST Una versión superior a 2017-05-03 mediante el uso del encabezado de solicitudx-ms-version.
Plantilla de Resource Manager versión 2 mediante la propiedad "version":2 dentro del objeto partitionKey.

Actualmente, no se pueden usar contenedores con una clave de partición de gran tamaño dentro de Power BI ni de Azure Logic Apps. Puede usar contenedores sin una clave de partición de gran tamaño desde estas aplicaciones.

Pasos siguientes