Usando o Python no InterSystems IRIS

Vamos neste breve artigo ver como podemos utilizar o python como linguagem de programação dentro o InterSystems IRIS. Para o nosso exemplo vamos criar um método que exporta os dados de uma tabela do IRIS para um arquivo no formato XLS (MS-Excel). Para isso vamos utilizar a biblioteca pandas do python.

Primeiro, vamos ver a nossa tabela.:

Class Demo.Alunos Extends (%Persistent, %Populate)
{

Property name As %String(MAXLEN = 100);

Property dob As %Date(FORMAT = 4);

Property sex As %String(VALUELIST = ",F,M");

Property course As %String(VALUELIST = ",Engenharia,Arquitetura,Direito,Artes,Letras,Psicologia,Musica");

Property note1 As %Integer(MAXVAL = 10, MINVAL = 0);

Property note2 As %Integer(MAXVAL = 10, MINVAL = 0);

Property debt As %Boolean;

}

Note que estamos utilizando a superclasse %Populate na nossa classe Demo.Alunos. Esta superclasse nos permite popular a nossa tabela com dados que serão criados baseado no tipo de cada propriedade. Para mais detalhes do %Populate veja o link https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GOBJ_populate

Compilada nossa classe, vamos abrir o terminal do Iris e pedir para criar 100 registros na nossa tabela:

Após criar os registros vamos verificar como ficou a nossa tabela. Abra o SQL Explorer no Portal de Administração do IRIS e veja o conteúdo da tabela:

Pronto. Temos nossa tabela criada e populada com 100 registros. Agora precisamos ver o python. Veja o link da documentação do IRIS a seguir: https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_epython

Este link apresenta a documentação de instalação do python no IRIS para os diversos ambientes, e também o uso do irispip (até o IRIS 2024.1) ou pip (a partir do IRIS 2024.2) para a instalação de pacotes.

Uma vez instalado e configurado o python vamos abrir o shell python a partir do terminal do IRIS apenas para verificar se está tudo ok. Veja a tela a seguir:

Ótimo. Estamos com o ambiente montado e pronto para avançarmos. Vamos agora para o pacote que vamos utilizar, o pandas. Para maiores detalhes sobre este pacote veja o link a seguir: https://pandas.pydata.org/

Instale o pandas no seu ambiente obedecendo a documentação do IRIS. Veja o diretório de instalação dos pacotes e qual utilitário (irispip ou pip) usar (vai depender da sua versão de IRIS).

No meu ambiente (IRIS 2024.1) o comando seria, via shell do Windows, ir para o diretório bin da instalação do IRIS e executar o seguinte comando:

.\irispip install --target c:\InterSystems\IRIS_ISS\mgr\python pandas

No meu exemplo o pacote pandas será instalado em mgr\python da minha instalação de IRIS. Veja o caminho para mgr\python da sua instalação e ajuste o comando.

 Instalado o pandas vamos ao código do nosso método que exporta os dados para o Excel:

Class Python.Exporta [ Abstract ]
{

ClassMethod tabela() As %Status [ Language = python ]
{

              import iris
              import pandas as pd
             
              rs = iris.sql.exec("select * from demo.alunos")
              df = rs.dataframe()

              # Salvar o DataFrame como um arquivo XLS
              caminho_arquivo = 'c:\\temp\\dados.xlsx'
              df.to_excel(caminho_arquivo, index=False)
             
              return True
}

}

Salve e compile a classe. Uma vez criado o código vamos executa-lo via terminal:

Pronto. Agora é só ir até o local de criação e abrir a tabela:

O código python é bem simples. Primeiro criamos um recordset a partir do comando SQL para recuperar as linhas da nossa tabela. Depois convertemos esse recordset em um dataframe pandas. Então usamos o dataframe para exportar os dados no formato XLS.

Este é um exemplo simples de uso do python. Existem várias bibliotecas úteis prontas e disponíveis para uso.

Até a próxima!