SQLTools é uma extensão do Visual Studio Code (VS Code) com mais de 3,5 milhões de downloads, que fornece conexões para muitos dos bancos de dados mais usados, incluindo o InterSystems IRIS, utilizando drivers.

Para desenvolvedores que são novos no VS Code, ou aqueles já familiarizados com ele mas que desejam simplificar suas conexões com o InterSystems IRIS, este tutorial irá guiá-lo na instalação da extensão SQLTools e do driver do InterSystems IRIS. Em seguida, ele mostra como estabelecer uma conexão com sua instância do InterSystems IRIS e executar uma consulta.

Você vai precisar de: VS Code instalado em seu sistema e acesso a uma instância do Intersystems IRIS.
 

Instalando a extensão SQLTools e o driver do InterSystems IRIS

1. Abra o VS Code.
2. Navegue até a visão de Extensões na Barra de Atividades ou pressione Ctrl+Shift+X.
3. Na barra de pesquisa, digite "SQLTools" e pressione Enter.
4. Localize a extensão SQLTools nos resultados da pesquisa e clique no botão "Install" (Instalar).
5. Aguarde a conclusão da instalação e, em seguida, feche a aba. Observe o novo ícone do SQLTools na sua Barra de Atividades.
6. Na barra de pesquisa de Extensões, digite "SQLTools IRIS" e pressione Enter.
7. Encontre a extensão SQLTools InterSystems IRIS nos resultados da pesquisa e clique no botão "Install" (Instalar).
8. Após a instalação ser concluída com sucesso, feche a aba.

Conectando ao InterSystems IRIS

1. Vá até o ícone do SQLTools na Barra de Atividades.
2. Clique em “Add New Connection” (Adicionar Nova Conexão) e selecione o driver “InterSystems IRIS”.
3. Digite um nome para a sua conexão.
4. Preencha os detalhes da conexão e, opcionalmente, configure definições adicionais de acordo com seu ambiente.
5. Teste a conexão usando o botão “Test Connection” (Testar Conexão).
6. Depois que a conexão for testada com sucesso, clique em “Save Connection” (Salvar Conexão) para criá-la.

Executando uma Consulta

1. Navegue até o ícone do SQLTools na Barra de Atividades, onde você verá suas conexões.
2. Clique com o botão direito na conexão que deseja usar e selecione “Connect” (Conectar) no menu de contexto.
3. Uma vez conectado, escreva uma consulta simples.
4. Clique em “Run on active connection” (Executar na conexão ativa).
5. O SQLTools irá gerar os resultados, exibidos no painel à direita.
6. Para explorar as tabelas do seu banco de dados, expanda sua conexão na Barra Lateral Principal.
7. Selecione “Show Table Record” (Ctrl+E Ctrl+S) ou clique no ícone da lupa.
8. Clique em “Open” (Abrir) e em “Open results as JSON” (Abrir resultados como JSON).

Espero que você tenha achado este tutorial útil e que o uso do SQLTools ajude a agilizar seu ambiente de desenvolvimento no VS Code. Se você experimentar, adoraria saber como foi sua experiência!

Se você está começando com o InterSystems ObjectScript, certamente vai se deparar com o comando XECUTE.
E iniciantes podem se perguntar: onde e por que eu precisaria usar isso?

A documentação oficial traz uma rica coleção de trechos de código, mas nenhum caso prático.
Recentemente, encontrei um caso de uso que gostaria de compartilhar com você.

O cenário:
Quando você constrói um container do IRIS com Docker, na maioria dos casos,
você executa o script de inicialização.

iris session iris < iris.script 

Isso significa que você abre uma sessão de terminal e fornece sua entrada linha por linha a partir do script.
E isso funciona bem e é fácil se você estiver chamando métodos, funções ou comandos.
Mas percorrer várias linhas em loop não é possível.
Você pode argumentar que executar um loop FOR em uma linha não é uma obra-prima.
Certo, mas as linhas não são infinitas e o código deve permanecer manutenível.

Um objetivo diferente era não deixar rastros de código após a configuração.
Então, iris.script foi o local para aplicá-lo.

A solução:
XECUTE me permitiu encadear meu código de múltiplas linhas.
Para evitar conflitos com escopo de variáveis, usei apenas %Variables
Aliás: o objetivo era popular algumas LookupTables de demonstração.
Só para conforto, usei nomes de métodos de %PopulateUtils como nomes de tabelas.

   ;; generate some demo lookup tables   
   ; inner loop by table
    set %1="for j=1:1:5+$random(10) XECUTE %2,%3,%4"
    ; populate with random values
    set %2="set %key=##class(%PopulateUtils).LastName()"
    set %3="set %val=$ClassMethod(""%PopulateUtils"",%tab)"
    ; write the table
    set %4="set ^Ens.LookupTable(%tab,%key)=%val"
    set %5="set ^Ens.LookupTable(%tab)=$lb($h) write !,""LookupTable "",%tab"
    ; main loop
    XECUTE "for %tab=""FirstName"",""City"",""Company"",""Street"",""SSN"" XECUTE %1,%5"
    ;; just in Docker

O resultado atendeu aos requisitos sem deixar rastros permanentes e
não interferiu com o código depositado no IPM.
Portanto, foi usado apenas uma vez durante a construção do container Docker.