Endereços e depuração

A extensão permite salvar mais de um endereço de servidor para cada base de dados e alternar entre eles de forma prática. O uso mais comum para múltiplos endereços é a depuração, em que é necessário acessar um Engine local. Neste guia, explicaremos como salvar múltiplos endereços de servidor e em que isto é útil para depurar uma base de dados.

Endereços de servidor

Para modificar o endereço do servidor de uma base de dados, o usuário pode utilizar o comando Engine DevTools: Change Server Address, o atalho Ctrl+E A ou a opção Change Server Address no menu da base. No primeiro uso do comando, a seguinte caixa de entrada será exibida:

O usuário deve inserir o novo endereço e pressionar “enter”. A nova URL passará a ser usada e o antigo endereço será movido para a lista de endereços salvos.

Nos usos seguintes do comando, quando já houver uma lista de endereços salvos, o seguinte menu será exibido:

São listados na seguinte ordem:

• Todos os endereços salvos anteriormente.
• Opção “New” para adicionar um novo endereço.
• Opção “Current”, indicando o atual endereço sendo utilizado pela base.

O usuário pode escolher trocar o endereço usado atualmente por algum dos já salvos ou selecionar a opção “New” para entrar com novo endereço.

Para remover endereços, basta pressionar o botão com ícone de lixo do lado direito do nome do endereço. Caso a lista de endereços salvos fique vazia novamente, o próximo uso do comando será como o primeiro uso, pulando diretamente para a etapa em que um novo endereço deve ser inserido.

Depuração

A extensão não possui a funcionalidade de depuração, sendo ainda necessário o uso da IDE do Engine. No entanto, é possível utilizar o depurador da IDE do Engine para depurar códigos executados pela extensão. Basta que o endereço do servidor da base de dados na extensão aponte para o Engine local.

O usuário deve observar em que porta o Engine local foi inicializado e usar o seguinte endereço na extensão:

localhost:<porta>

Recomenda-se que o usuário adicione o endereço do Engine local usando o comando Change Server Address que foi explicado acima. Dessa forma, os endereços remoto e local ficam ambos salvos, sendo possível alternar entre os dois de forma prática.

Conectando ao Engine local

Com a opção “Conectar VS Code” no menu do Engine, o usuário atualiza o endereço de uma conexão ou cria uma conexão nova no VS Code utilizando o endereço do Engine local.

O último workspace utilizado no VS Code é aberto e o endereço da base de dados correspondente é alterado para o endereço do Engine local sendo utilizado. Os antigos endereços com portas altas (na prática, portas aleatórias utilizadas pelo Engine) são apagados. Caso não haja uma conexão criada para aquela base, o fluxo de criação é aberto com o endereço preenchido.

Configurando portas fixas

Para garantir que uma determinada base sempre inicialize seu Engine local com a mesma porta do endereço salvo na extensão, é possível fixar a porta nas propriedades do atalho da base. Basta inserir --httpPort=<porta> ao final do “destino”. No exemplo a seguir, fixamos a porta 8081 para a base NGINSTACK:

Como a inicialização do Engine falha caso a porta fixa já esteja em uso, não recomendamos por ora o uso dessa estratégia. Para uma maior praticidade, prefira utilizar a opção “Conectar VS Code” disponível no menu do Engine.