Partilhar via

az cosmosdb sql database

Note

Este grupo de comandos tem comandos definidos tanto no CLI do Azure como em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerir bases de dados SQL do Azure Cosmos DB.

Comandos

Name Description Tipo Status
az cosmosdb sql database create

Crie uma base de dados SQL numa conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database delete

Elimine a base de dados SQL com uma conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database exists

Verifica se existe uma base de dados SQL do Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database list

Liste as bases de dados SQL numa conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database merge

Mescle as partições de um banco de dados sql.

 Extension Preview
az cosmosdb sql database restore

Restaure um banco de dados sql excluído dentro da mesma conta.

 Core disponibilidade geral
az cosmosdb sql database restore (cosmosdb-preview extensão)

Restaure um banco de dados sql excluído dentro da mesma conta.

 Extension Preview
az cosmosdb sql database show

Mostre os detalhes de uma base de dados SQL numa conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database throughput

Gerir o throughput da base de dados SQL numa conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database throughput migrate

Migre a taxa de transferência do banco de dados SQL entre o dimensionamento automático e o provisionamento manual.

 Core disponibilidade geral
az cosmosdb sql database throughput show

Obtenha o throughput da base de dados SQL numa conta Azure Cosmos DB.

 Core disponibilidade geral
az cosmosdb sql database throughput update

Atualize o débito da base de dados SQL através de uma conta Azure Cosmos DB.

 Core disponibilidade geral

az cosmosdb sql database create

Editar

Crie uma base de dados SQL numa conta Azure Cosmos DB.

az cosmosdb sql database create --account-name
                                --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--max-throughput]
                                [--throughput]

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--max-throughput

O recurso de taxa de transferência máxima pode ser dimensionado para (RU/s). Fornecido quando o recurso está habilitado para dimensionamento automático. O valor mínimo pode ser 4000 (RU/s).

--throughput

A taxa de transferência do banco de dados SQL (RU/s). O valor padrão é 400.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database delete

Editar

Elimine a base de dados SQL com uma conta Azure Cosmos DB.

az cosmosdb sql database delete --account-name
                                --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--yes]

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database exists

Editar

Verifica se existe uma base de dados SQL do Azure Cosmos DB.

az cosmosdb sql database exists --account-name
                                --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database list

Editar

Liste as bases de dados SQL numa conta Azure Cosmos DB.

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

Exemplos

Liste as bases de dados SQL numa conta Azure Cosmos DB (autogerada)

az cosmosdb sql database list --account-name MyAccount --resource-group MyResourceGroup

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database merge

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mescle as partições de um banco de dados sql.

az cosmosdb sql database merge --account-name
                               --name
                               --resource-group
                               [--acquire-policy-token]
                               [--change-reference]

Exemplos

Mesclar partições do banco de dados my-database

az cosmosdb sql database merge -g my-resource-group -a my-account --name my-database

Parâmetros Obrigatórios

--account-name -a

Nome da conta de banco de dados do CosmosDB.

--name -n

Nome do nome do banco de dados do CosmosDB.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database restore

Editar

Restaure um banco de dados sql excluído dentro da mesma conta.

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--disable-ttl]
                                 [--restore-timestamp]

Exemplos

Restaure um banco de dados sql excluído dentro da mesma conta.

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

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--disable-ttl

Sinalizador para restaurar com TTL desativado.

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

--restore-timestamp -t

O carimbo de data/hora para o qual o banco de dados precisa ser restaurado.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database restore (cosmosdb-preview extensão)

Pré-visualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Restaure um banco de dados sql excluído dentro da mesma conta.

az cosmosdb sql database restore --account-name
                                 --name
                                 --resource-group
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--disable-ttl {false, true}]
                                 [--restore-timestamp]

Exemplos

Restaure um banco de dados sql excluído dentro da mesma conta.

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

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--disable-ttl
Pré-visualizar

Ative ou desative a restauração com ttl desativado.

Propriedade Valor
Valores aceites: false, true
--restore-timestamp -t

O carimbo de data/hora para o qual o banco de dados precisa ser restaurado.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az cosmosdb sql database show

Editar

Mostre os detalhes de uma base de dados SQL numa conta Azure Cosmos DB.

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

Parâmetros Obrigatórios

--account-name -a

Nome da conta Cosmosdb.

--name -n

Nome do banco de dados.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False