Gerenciando Conexões de Linguagens Externas com "irisconns"

Ao trabalhar com linguagens externas para o IRIS (como Python e Node.js), uma das primeiras coisas que você precisa fazer é estabelecer uma conexão com uma instância do IRIS.

Por exemplo, para criar uma conexão em Python (https://pypi.org/project/intersystems-irispython/):

import iris

# Open a connection to the server
args = {
	'hostname':'127.0.0.1', 
	'port': 1972,
	'namespace':'USER', 
	'username':'username', 
	'password':'password'
}
conn = iris.connect(**args)

# Create an iris object
irispy = iris.createIRIS(conn)

# Create a global array in the USER namespace on the server
irispy.set("myGlobal", "hello world!") 

Para estabelecer uma conexão, você deve ou codificar as informações de conexão diretamente no seu script ou solicitar essas informações ao usuário.

Para ajudar a gerenciar essas conexões com o IRIS em meus próprios projetos, criei o risconns no Open Exchange.

O irisconns permite desacoplar as informações de conexão do seu projeto/código, permitindo que você salve essas informações em arquivos separados do seu código. (Pense em “DSN” e “ODBC” para suas conexões do IRIS Native SDK.)

Começando

Para começar com o irisconns, crie um arquivo irisconns ou .irisconns no diretório de trabalho do seu projeto, em qualquer diretório pai do seu diretório de trabalho ou no seu diretório pessoal. Preencha seu arquivo irisconns com informações de conexão no formato de arquivo INI:

# 'default' is the connection returned if no name is provided.
[default]
hostname = localhost
port = 1972
namespace = USER
username = _SYSTEM
# confirm password? true or false?
confirm = false

# This connection name is "TEST".
[TEST]
hostname = test-server
port = 1972
namespace = USER
username = _SYSTEM
# confirm password? true or false?
confirm = false

# This connection name is "PROD".
[PROD]
hostname = prod-server
port = 1972
namespace = %SYS
username = _SYSTEM
# confirm password? true or false?
confirm = false

Você também precisará copiar as bibliotecas associadas irisconns.py ou irisconns.js para o seu projeto, para que possa importar o módulo irisconns no seu código. (Atualmente, existem apenas bibliotecas para Python e Node.js.) Você também precisa instalar os pacotes nativos do IRIS para a sua linguagem de programação:

# Install Dependencies for Python
cp /path/to/irisconns/irisconns.py ./irisconns.py
pip install intersystems-irispython

# Install Dependencies for Node.js
cp /path/to/irisconns/irisconns.js ./irisconns.js
npm install @intersystems/intersystems-iris-native

Usando o "irisconns"

Uma vez instalado, você deverá ser capaz de usar/solicitar sua configuração de conexão:

# Python Connection Example
import irisconns

# default connection
irispy = irisconns.get_irispy()

# named connection
irispy = irisconns.get_irispy('TEST')

# usage
irispy.set('hello world!', 'test', 1)

// Javascript Connection Example

// Import the package
const irisconns = require('./irisconns.js');

// Wrap in an async function so we can await the connection...
(async () => {
  // 'default' connection
  const iris = await irisconns.get_iris();

  // named (i.e. "PROD") connection
  // const iris = await irisconns.get_iris('PROD');

  // usage
  iris.set('hello world!','test',1);
})()

O código acima produzirá solicitações, semelhantes às seguintes:

# Connecting to default
Hostname    : localhost (default)
Port        : 11972
Namespace   : USER (default)
Username    : _SYSTEM
Password    : [hidden]
Confirm     : [hidden]

Encerramento

Você pode encontrar mais informações sobre o irisconns na página do Open Exchange. Espero que você ache útil!

Obrigado!