https://github.com/coplin-ufsm/db2

Um módulo de conveniência para acessar bancos de dados do tipo IBM DB2.
https://github.com/coplin-ufsm/db2

database ibm plugin

Last synced: 6 days ago
JSON representation

Um módulo de conveniência para acessar bancos de dados do tipo IBM DB2.

• Host: GitHub
• URL: https://github.com/coplin-ufsm/db2
• Owner: COPLIN-UFSM
• License: mit
• Created: 2023-06-05T10:34:45.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-10-21T11:38:50.000Z (27 days ago)
• Last Synced: 2024-10-23T12:05:23.483Z (25 days ago)
• Topics: database, ibm, plugin
• Language: Python
• Homepage: https://pypi.org/project/coplin-db2/
• Size: 105 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# coplin-db2

A biblioteca coplin-db2 é um módulo de conveniência para acessar bancos de dados do tipo IBM DB2, desenvolvido pela 

Coordenadoria de Planejamento Informacional da UFSM (COPLIN).

Com esta biblioteca, é possível definir um arquivo com credenciais de acesso ao banco de dados, no formato `json`, que 

podem ser utilizadas posteriormente:

Arquivo `credentials.json`:

```json

{

  "user": "nome_de_usuário",

  "password": "sua_senha_aqui",

  "host": "URL_do_host",

  "port": 50000,

  "database": "nome_do_banco"

}

```

Arquivo `db2_schema.sql`:

```sql

CREATE TABLE USERS_TEST_IBMDB2(

    ID INTEGER NOT NULL PRIMARY KEY,

    NAME VARCHAR(10) NOT NULL,

    AGE INTEGER NOT NULL

);

INSERT INTO USERS_TEST_IBMDB2(ID, NAME, AGE) VALUES (1, 'HENRY', 32);

INSERT INTO USERS_TEST_IBMDB2(ID, NAME, AGE) VALUES (2, 'JOHN', 20);

```

Arquivo `main.py`:

```python

import os

from db2 import DB2Connection

# arquivo JSON com credenciais de login para o banco de dados

credentials = 'credentials.json'

with DB2Connection(credentials) as db2_conn:

    db2_conn.create_tables('db2_schema.sql')

    query_str = '''

        SELECT * 

        FROM USERS_TEST_IBMDB2;

     ''' 

    df = db2_conn.query_to_dataframe(query_str)

    

    print(df)

    

    # deleta a tabela

    # db2_conn.modify('''DROP TABLE USERS_TEST_IBMDB2;''', suppress=False)

```

A saída esperada deve ser:

```bash

   ID   NAME  AGE

0   1  HENRY   32

1   2   JOHN   20

```

## Instalação

Para instalar o pacote pelo pip, digite o seguinte comando:

```bash

pip install coplin-db2

```

## Documentação

A documentação está disponível em https://coplin-ufsm.github.io/db2

## Desenvolvimento

Para instruções de desenvolvimento do pacote, consulte [este arquivo](https://github.com/COPLIN-UFSM/db2/blob/main/DEVELOPMENT.md).

## Contato

Biblioteca desenvolvida originalmente por Henry Cagnini: [[email protected]]()

Caso encontre algum problema no uso, abra um issue no [repositório da biblioteca](https://github.com/COPLIN-UFSM/db2).

Pull requests são bem-vindos!