contexto azdata

Aplica-se a: CLI de Dados do Azure (azdata)

Observação

Alguns cenários tratados anteriormente pela CLI de Dados do Azure (azdata) agora são gerenciados por meio de extensões da CLI do Azure (az) e fluxos de trabalho baseados no Azure Arc. Não há uma única substituição 1:1 para todos os azdata comandos. A tabela a seguir realça alternativas da CLI do Azure comumente relacionadas onde elas existem.

azdata command area	Extensão/grupo de comandos da CLI do Azure	Referência do Azure CLI
azdata arc dc *	az arcdata	Referência da CLI de dados do Azure Arc
azdata arc sql mi *	az arcdata sql mi	Gerenciar a Instância Gerenciada de SQL do Azure com a CLI
azdata arc postgres *	az arcdata postgres	Gerenciar o servidor PostgreSQL com a CLI
azdata migrate *	az datamigration	Migrar usando a CLI
azdata extension *	az extension *	Visão geral das extensões da CLI do Azure
azdata login	az login	az login
azdata sql shell / azdata sql query	Nenhuma CLI do Azure equivalente (use sqlcmd, SSMS ou outras ferramentas SQL)	Utilitário sqlcmd SQL Server Management Studio

Para novos cenários de automação e gerenciamento, prefira a CLI do Azure (az), as extensões da CLI do Azure e as experiências do portal do Azure Arc.

O artigo a seguir fornece referência para os comandos sql na ferramenta azdata. Para obter mais informações sobre outros comandos de azdata, confira referência de azdata

Comandos

Command	Descrição
azdata context list	Lista os contextos disponíveis no perfil do usuário.
azdata context delete	Exclui o contexto com o namespace fornecido do perfil do usuário.
azdata context set	Define o contexto com o namespace fornecido como o contexto ativo no perfil do usuário.

azdata context list

Você pode definir ou excluir qualquer um deles com azdata context set ou azdata context delete. Para fazer logon em um novo contexto, use azdata login.

azdata context list [--active -a] 
                    

Exemplos

Lista todos os contextos disponíveis no perfil do usuário.

azdata context list

Lista o contexto ativo no perfil do usuário.

azdata context list --active

Parâmetros opcionais

--active -a

Liste apenas o contexto ativo no momento.

Argumentos globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--output -o

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

--query -q

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

--verbose

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

azdata context delete

Se o contexto excluído estiver ativo, o usuário precisará definir um novo contexto ativo. Para ver os contextos disponíveis para definir ou excluir azdata context list. Quando um namespace é fornecido que corresponde a vários namespaces de contexto, você deve fornecer todos [--namespace --username --endpoint] para exclusividade para excluir esse contexto.

azdata context delete --namespace -ns 
                      [--endpoint -e]  
                      
[--username -u]

Exemplos

Exclui o contexto no perfil do usuário com base em um namespace exclusivo.

azdata context delete --namespace contextNamespace

Exclui o contexto no perfil do usuário com base no namespace, nome de usuário e ponto de extremidade do controlador.

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080

Parâmetros Necessários

--namespace -ns

Namespace do contexto que você gostaria de excluir.

Parâmetros opcionais

--endpoint -e

Ponto de extremidade do controlador de cluster "https://host:port".

--username -u

Usuário da conta.

Argumentos globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--output -o

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

--query -q

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

--verbose

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

azdata context set

Para ver os contextos disponíveis para definir azdata context list. Se nenhum contexto estiver listado, você precisará fazer logon para criar um contexto em seu perfil azdata loginde usuário. O que você fizer logon se tornará seu contexto ativo. Se você fizer logon em várias entidades, poderá alternar entre contextos ativos com esse comando. Para ver seu contexto ativo no momento azdata context list --active. Quando um namespace é fornecido que corresponde a vários namespaces de contexto, você deve fornecer todos [--namespace --username --endpoint] para exclusividade para definir o contexto ativo.

azdata context set --namespace -ns 
                   [--endpoint -e]  
                   
[--username -u]

Exemplos

Define o contexto ativo no perfil do usuário com base em um namespace exclusivo.

azdata context set --namespace contextNamespace

Define o contexto ativo no perfil do usuário com base no namespace, nome de usuário e ponto de extremidade do controlador.

azdata context set --namespace contextNamespace --username johndoe --endpoint https://<ip or domain name>:30080     

Parâmetros Necessários

--namespace -ns

Namespace do contexto que você gostaria de definir.

Parâmetros opcionais

--endpoint -e

Ponto de extremidade do controlador de cluster "https://host:port".

--username -u

Usuário da conta.

Argumentos globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--output -o

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

--query -q

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

--verbose

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

Próximas Etapas 

Para obter mais informações sobre outros comandos de azdata, confira referência de azdata.

Para saber mais sobre como instalar a ferramenta azdata, confira Instalar azdata.