Compartir a través de

az cosmosdb sql container

Note

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administración de contenedores de SQL de Azure Cosmos DB.

Comandos

Nombre Description Tipo Estado
az cosmosdb sql container create

Cree un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container create (cosmosdb-preview extensión)

Cree un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Extension GA
az cosmosdb sql container delete

Elimine el contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container exists

Comprueba si existe un contenedor SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container list

Enumere los contenedores de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container merge

Combina las particiones de un contenedor sql.

 Extension Preview
az cosmosdb sql container redistribute-partition-throughput

Redistribuye el rendimiento de la partición de un contenedor sql.

 Extension Preview
az cosmosdb sql container restore

Restaure un contenedor sql eliminado dentro de la misma cuenta.

 Core GA
az cosmosdb sql container restore (cosmosdb-preview extensión)

Restaure un contenedor sql eliminado dentro de la misma cuenta.

 Extension Preview
az cosmosdb sql container retrieve-partition-throughput

Recupere el rendimiento de la partición de un contenedor sql.

 Extension Preview
az cosmosdb sql container show

Muestra los detalles de un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container throughput

Administre el rendimiento del contenedor de SQL en una cuenta de Azure Cosmos DB.

 Núcleo y extensión GA
az cosmosdb sql container throughput migrate

Migre el rendimiento del contenedor de SQL entre el escalado automático y el aprovisionado manualmente.

 Core GA
az cosmosdb sql container throughput migrate (cosmosdb-preview extensión)

Migre el rendimiento del contenedor de SQL entre el escalado automático y el aprovisionado manualmente.

 Extension GA
az cosmosdb sql container throughput show

Obtenga el rendimiento del contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container throughput show (cosmosdb-preview extensión)

Obtenga el rendimiento del contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Extension GA
az cosmosdb sql container throughput update

Actualice el rendimiento del contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container throughput update (cosmosdb-preview extensión)

Actualice el rendimiento del contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Extension GA
az cosmosdb sql container update

Actualice un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Core GA
az cosmosdb sql container update (cosmosdb-preview extensión)

Actualice un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

 Extension GA

az cosmosdb sql container create

Editar

Cree un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container create --account-name
                                 --database-name
                                 --name
                                 --partition-key-path
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--cep]
                                 [--conflict-resolution-policy]
                                 [--full-text-policy]
                                 [--idx]
                                 [--max-throughput]
                                 [--partition-key-version]
                                 [--throughput]
                                 [--ttl]
                                 [--unique-key-policy]
                                 [--vector-embeddings]

Ejemplos

Cree un contenedor sql de Azure Cosmos DB.

az cosmosdb sql container create -g MyResourceGroup -a MyAccount -d MyDatabase -n MyContainer --partition-key-path "/my/path" --idx @policy-file.json --ttl 1000 --throughput "700"

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--partition-key-path -p

Ruta de acceso de la clave de partición, por ejemplo, "/address/zipcode".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--analytical-storage-ttl -t

TTL analítico, cuando se habilita el almacenamiento analítico.

--cep

Directiva de cifrado de cliente, puede escribirla como una cadena o como un archivo, por ejemplo, --cep @policy-file.json o --cep "{"includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}],"policyFormatVersion": 2}".

--conflict-resolution-policy -c

Directiva de resolución de conflictos, puede escribirla como una cadena o como un archivo, por ejemplo, --conflict-resolution-policy @policy-file.json o --conflict-resolution-policy "{"mode": "lastWriterWins", "conflictResolutionPath": "/path"}".

--full-text-policy

Directiva de texto completo, puede escribirla como una cadena o como un archivo, por ejemplo, --full-text-policy @policy-file.json o --full-text-policy "{"fullTextPaths": [{"path": "/ftPath1", "language": "en-US" }]}".

--idx

Directiva de indexación, puede escribirla como una cadena o como un archivo, por ejemplo, --idx @policy-file.json o --idx "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}],"vectorIndexes": [{"path": "/vector1","type": "flat"}]}".

Propiedad Valor
Valor predeterminado: { "indexingMode": "consistent", "automatic": true, "includedPaths": [ { "path": "/*" } ], "excludedPaths": [ { "path": "/\"_etag\"/?" } ] }
--max-throughput

El recurso de rendimiento máximo puede escalar a (RU/s). Se proporciona cuando el recurso está habilitado para el escalado automático. El valor mínimo puede ser 4000 (RU/s).

--partition-key-version

Versión de la clave de partición.

--throughput

Rendimiento del contenedor de SQL (RU/s). El valor predeterminado es 400. Omita este parámetro si la base de datos tiene un rendimiento compartido a menos que el contenedor tenga un rendimiento dedicado.

--ttl

TTL predeterminado. Si falta el valor o se establece en "-1", los elementos no expiran. Si el valor se establece en "n", los elementos expirarán "n" segundos después de la hora de última modificación.

--unique-key-policy -u

Directiva de clave única, puede escribirla como una cadena o como un archivo, por ejemplo, --unique-key-policy @policy-file.json o --unique-key-policy "{"uniqueKeys": [{"paths": ["/path/to/key1"]}, {"paths": ["/path/to/key2"]}]}".

--vector-embeddings

Directiva de inserción de vectores, puede escribirla como una cadena o como un archivo, por ejemplo, --vector-embeddings @policy-file.json o --vector-embeddings "{"vectorEmbeddings": [{"path": "/vector1", "dataType": "float32", "dimensions": 2, "distanceFunction": "dotproduct" }]}".

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container create (cosmosdb-preview extensión)

Cree un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container create --account-name
                                 --database-name
                                 --name
                                 --partition-key-path
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--cep]
                                 [--conflict-resolution-policy]
                                 [--idx]
                                 [--materialized-view-definition]
                                 [--max-throughput]
                                 [--partition-key-version]
                                 [--throughput]
                                 [--ttl]
                                 [--unique-key-policy]

Ejemplos

Cree un contenedor sql de Azure Cosmos DB.

az cosmosdb sql container create -g MyResourceGroup -a MyAccount -d MyDatabase -n MyContainer --partition-key-path "/my/path" --idx @policy-file.json --ttl 1000 --throughput "700"

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--partition-key-path -p

Ruta de acceso de la clave de partición, por ejemplo, "/address/zipcode".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--analytical-storage-ttl -t

TTL analítico, cuando se habilita el almacenamiento analítico.

--cep

Directiva de cifrado de cliente, puede escribirla como una cadena o como un archivo, por ejemplo, --cep @policy-file.json o --cep "{ "includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}], "policyFormatVersion": 2}".

--conflict-resolution-policy -c

Directiva de resolución de conflictos, puede escribirla como una cadena o como un archivo, por ejemplo, --conflict-resolution-policy @policy-file.json o --conflict-resolution-policy "{ "mode": "lastWriterWins", "conflictResolutionPath": "/path" }".

--idx

Directiva de indexación, puede escribirlo como una cadena o como un archivo, por ejemplo, --idx @policy-file.json o --idx "{ "indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}] }".

Propiedad Valor
Valor predeterminado: { "indexingMode": "consistent", "automatic": true, "includedPaths": [ { "path": "/*" } ], "excludedPaths": [ { "path": "/\"_etag\"/?" } ] }
--materialized-view-definition -m

Definición de vista materializada, puede escribirla como una cadena o como un archivo, por ejemplo, --materialized-view-definition @materializedview-definition-file.json o --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "SELECT * FROM root r"}'.

--max-throughput

El recurso de rendimiento máximo puede escalar a (RU/s). Se proporciona cuando el recurso está habilitado para el escalado automático. El valor mínimo puede ser 4000 (RU/s).

--partition-key-version

Versión de la clave de partición.

--throughput

Rendimiento del contenedor de SQL (RU/s). El valor predeterminado es 400. Omita este parámetro si la base de datos tiene un rendimiento compartido a menos que el contenedor tenga un rendimiento dedicado.

--ttl

TTL predeterminado. Si falta el valor o se establece en "-1", los elementos no expiran. Si el valor se establece en "n", los elementos expirarán "n" segundos después de la hora de última modificación.

--unique-key-policy -u

Directiva de clave única, puede escribirla como una cadena o como un archivo, por ejemplo, --unique-key-policy @policy-file.json o --unique-key-policy "{ "uniqueKeys": [{"paths": ["/path/to/key1"]}, {"paths": ["/path/to/key2"]}] }".

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container delete

Editar

Elimine el contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container delete --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--yes]

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container exists

Editar

Comprueba si existe un contenedor SQL de Azure Cosmos DB.

az cosmosdb sql container exists --account-name
                                 --database-name
                                 --name
                                 --resource-group

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container list

Editar

Enumere los contenedores de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container list --account-name
                               --database-name
                               --resource-group

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container merge

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Combina las particiones de un contenedor sql.

az cosmosdb sql container merge --account-name
                                --database-name
                                --name
                                --resource-group

Ejemplos

combinar particiones del contenedor my-container

az cosmosdb sql container merge -g my-resource-group -a my-account -d my-db --name my-container

Parámetros requeridos

--account-name -a

Nombre de la cuenta de base de datos de CosmosDB.

--database-name -d

Nombre de la base de datos de CosmosDB.

--name -n

Nombre de la colección de CosmosDB.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container redistribute-partition-throughput

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Redistribuye el rendimiento de la partición de un contenedor sql.

az cosmosdb sql container redistribute-partition-throughput --account-name
                                                            --database-name
                                                            --name
                                                            --resource-group
                                                            [--evenly-distribute {false, true}]
                                                            [--source-partition-info]
                                                            [--target-partition-info]

Ejemplos

Distribuye uniformemente el rendimiento de la partición para un contenedor sql entre todas las particiones físicas.

az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --evenly-distribute

Redistribuye el rendimiento de la partición de un contenedor sql de las particiones de origen a las particiones de destino.

az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --target-partition-info 8=1200 6=1200]' --source-partition-info 9]'

Parámetros requeridos

--account-name -a

Nombre de la cuenta de base de datos de CosmosDB.

--database-name -d

Nombre de la base de datos de CosmosDB.

--name -n

Nombre de la colección de CosmosDB.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--evenly-distribute

Cambie para distribuir el rendimiento de forma equitativa entre todas las particiones físicas.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--source-partition-info

Identificadores de partición física de origen separados por espacios, por ejemplo: 1 2.

Propiedad Valor
Valor predeterminado: []
--target-partition-info

Información sobre el rendimiento de partición física de destino deseado, por ejemplo: 0=1200 1=1200.

Propiedad Valor
Valor predeterminado: []
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container restore

Editar

Restaure un contenedor sql eliminado dentro de la misma cuenta.

az cosmosdb sql container restore --account-name
                                  --database-name
                                  --name
                                  --resource-group
                                  [--disable-ttl]
                                  [--restore-timestamp]

Ejemplos

Restaure un contenedor sql eliminado dentro de la misma cuenta.

az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--disable-ttl

Marca para restaurar con TTL deshabilitado.

Uso: --disable-ttl True Default: false.

--restore-timestamp -t

Marca de tiempo a la que se debe restaurar el contenedor.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container restore (cosmosdb-preview extensión)

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Restaure un contenedor sql eliminado dentro de la misma cuenta.

az cosmosdb sql container restore --account-name
                                  --database-name
                                  --name
                                  --resource-group
                                  [--disable-ttl {false, true}]
                                  [--restore-timestamp]

Ejemplos

Restaure un contenedor sql eliminado dentro de la misma cuenta.

az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--disable-ttl
Vista previa

Habilite o deshabilite la restauración con ttl deshabilitado.

Propiedad Valor
Valores aceptados: false, true
--restore-timestamp -t

Marca de tiempo a la que se debe restaurar el contenedor.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container retrieve-partition-throughput

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Recupere el rendimiento de la partición de un contenedor sql.

az cosmosdb sql container retrieve-partition-throughput --account-name
                                                        --database-name
                                                        --name
                                                        --resource-group
                                                        [--all-partitions {false, true}]
                                                        [--physical-partition-ids]

Ejemplos

Recuperación del rendimiento del contenedor container_name para particiones físicas específicas

az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --physical-partition-ids 8 9

Recuperación del rendimiento del contenedor container_name para todas las particiones físicas

az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --all-partitions

Parámetros requeridos

--account-name -a

Nombre de la cuenta de base de datos de CosmosDB.

--database-name -d

Nombre de la base de datos de CosmosDB.

--name -n

Nombre del contenedor de CosmosDB.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--all-partitions

Cambie para recuperar el rendimiento de todas las particiones físicas.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--physical-partition-ids -p

Lista separada por espacios de identificadores de partición física.

Propiedad Valor
Valor predeterminado: []
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container show

Editar

Muestra los detalles de un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container show --account-name
                               --database-name
                               --name
                               --resource-group

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container update

Editar

Actualice un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container update --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--full-text-policy]
                                 [--idx]
                                 [--ttl]
                                 [--vector-embeddings]

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--analytical-storage-ttl -t

TTL analítico, cuando se habilita el almacenamiento analítico.

--full-text-policy

Directiva de texto completo, puede escribirla como una cadena o como un archivo, por ejemplo, --full-text-policy @policy-file.json o --full-text-policy "{"fullTextPaths": [{"path": "/ftPath1", "language": "en-US" }]}".

--idx

Directiva de indexación, puede escribirla como una cadena o como un archivo, por ejemplo, --idx @policy-file.json o --idx "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}],"vectorIndexes": [{"path": "/vector1","type": "flat"}]}".

--ttl

TTL predeterminado. Si falta el valor o se establece en "-1", los elementos no expiran. Si el valor se establece en "n", los elementos expirarán "n" segundos después de la hora de última modificación.

--vector-embeddings

Directiva de inserción de vectores, puede escribirla como una cadena o como un archivo, por ejemplo, --vector-embeddings @policy-file.json o --vector-embeddings "{"vectorEmbeddings": [{"path": "/vector1", "dataType": "float32", "dimensions": 2, "distanceFunction": "dotproduct" }]}".

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb sql container update (cosmosdb-preview extensión)

Actualice un contenedor de SQL en una base de datos SQL de Azure Cosmos DB.

az cosmosdb sql container update --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--idx]
                                 [--materialized-view-definition]
                                 [--ttl]

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Cosmosdb.

--database-name -d

Nombre de la base de datos.

--name -n

El nombre del contenedor.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--analytical-storage-ttl -t

TTL analítico, cuando se habilita el almacenamiento analítico.

--idx

Directiva de indexación, puede escribirlo como una cadena o como un archivo, por ejemplo, --idx @policy-file.json o --idx "{ "indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"}] }".

--materialized-view-definition -m

Definición de vista materializada, puede escribirla como una cadena o como un archivo, por ejemplo, --materialized-view-definition @materializedview-definition-file.json o --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "SELECT * FROM root r"}'.

--ttl

TTL predeterminado. Si falta el valor o se establece en "-1", los elementos no expiran. Si el valor se establece en "n", los elementos expirarán "n" segundos después de la hora de última modificación.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False