Rio de Janeiro,  
Banco de Dados Relacional OpenBase - Versão atual 11.0 

:: Menu ::
  • Principal
  • Produtos
  • Manuais
  • Downloads
  • Exemplos
  • Pesquisar
  • HOSPUB
  • Clientes
  • Suporte
  • Sobre


  • :: Contatos ::
    Contato
  • Contato





  •  

    Interface OPUS - TSQL
     
    A partir da versão 10.4 do OpenBase é possível com a opus executar query's.
     
     


    Veja a baixo as funções:


    1) tsql_connect - Abre uma conexão
    int tsql_connect (pointer id_conexao, cadeia conexão, cadeia usuário, cadeia password)
    conexão : cadeia do tipo “HST=…;DSN=…;UID=…;PWD=….;etc…”
    usuário : corresponde à palavra de nível.
    password : corresponde ao código de segurança
    retorna 0 e uma identificação de conexão do tipo pointer ou -1 se erro.
    Se na conexão, forem atribuidos valores aos itens UID e PWD(palavra de nível e código de segurança), esses valores terão prioridade sobre os valores passados pelos parâmetros (usuário e password.)
    Ex:
    pointer con
    if tsql_connect(con, “HST=10.1.1.26;DSN=/home/banco/teste“,””,””) = -1
    ? “erro na conexao”
    quit
    endif

    2) tsql_close - Termina uma conexão
    int tsql_close (pointer id_conexão)
    id_conexão : identificação da conexão do tipo pointer
    retorna 0 se sucesso, -1 se erro.

    3) tsql_query - executa um commando SQL
    int tsql_query( pointer id_conexão, cadeia query, pointer id_resultado)
    id_conexão : identificação de uma conexão aberta
    query : texto do commando SQL
    retorna 0 e uma identificação de resultado ou -1 se erro
    Ex:
    pointer con
    pointer res
    r=tsql_query(con, “select * from PESSOA”, res)

    4) tsql_num_fields - devolve o número de colunas de uma linha
    int tsql_num_fields ( pointer id_resultado);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query .
    retorna número de colunas ou -1 se erro.
    Se o número de colunas retornados for igual a zero, o commando SQL executado, não é um commando SELECT.

    5) tsql_fetch_row - lê a proxima linha de um conjunto resultado em uma string com valores separados por delimitador
    int tsql_fetch_row( pointer id_resultado, cadeia campos, cadeia separador )
    id_resultado : identificador de resultado devolvido por uma chamada sql_query para um commando SQL do tipo SELECT.
    campos : area de retorno da linha
    separador: cadeia cujo primeiro caracter é o separador dos campos
    retorna 0 se existe a linha, se não retorna -1
    tsql_fetch_row retorna a próxima linha de um conjunto resultado . Cada coluna é concatenada com os valores anteriores separados pelo separador especificado.
    Ex.:
    private cad(500)
    r=tsql_fetch_row_(res, cad, “|”)

    6) tsql_fetch_row_array - lê a proxima linha de um conjunto resultado em um vetor
    int tsql_fetch_row_array( pointer id_resultado, vetor campos )
    id_resultado : identificador de resultado devolvido por uma chamada sql_query para um commando SQL do tipo SELECT.
    campos: vetor cadeia onde retornarão os valores dos campos
    retorna 0 se existe a linha, se não retorna -1
    tsql_fetch_row_array retorna a próxima linha de um conjunto resultado . Cada coluna é armazenada numa célula de um array.
    Ex.:
    n=tsql_num_fields(res)
    decl vr[n]=space(20)
    r=tsql_fetch_row_array(res, vr)

    7) tsql_affected_rows – número de linhas alteradas
    int tsql_affected_rows(pointer id_resultado);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL .
    retorna número de linhas alteradas ou -1 se erro
    A função se aplica para os commandos SQL que alteram dados como INSERT, DELETE e UPDATE.

    8) tsql_field_name – devolve o nome de uma coluna
    int tsql_field_name(pointer id_resultado, int coluna, cadeia nome);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.
    coluna : número da coluna do conjunto resultado (a partir de zero)
    nome: cadeia que vai receber o nome da coluna
    retorna 0 e o nome da coluna ou -1 se erro

    9) tsql_field_type – devolve o tipo de uma coluna
    int tsql_field_type(pointer id_resultado, int coluna, cadeia tipo);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.
    coluna : número da coluna do conjunto resultado(a partir de zero)
    tipo: cadeia para receber o tipo da coluna
    retorna 0 e tipo da coluna ou –1 se erro

    10) tsql_field_length – devolve o tamanho interno de uma coluna
    int tsql_field_length(pointer id_resultado, int coluna);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.
    coluna : número da coluna do conjunto resultado(a partir de zero)
    retorna tamanho da coluna ou -1 se erro
    O tamanho interno equivale ao número de bytes que é retornado à uma aplicação.

    11) tsql_field_displen – devolve o tamanho de exibição de uma coluna
    int tsql_field_length(pointer id_resultado, int coluna);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.
    coluna : número da coluna do conjunto resultado(a partir de zero)
    retorna tamanho da coluna ou -1 se erro
    A função tsql_field_displen fornece o número máximo de bytes necessários para a exibição da coluna. Por exemplo para um tipo DECIMAL, o tamanho de exibição será igual ao tamanho interno acrescido de uma posição, decorrente do ponto decimal. No caso de um tipo CHAR, os tamanhos internos e de exibição são iguais.

    12) tsql_field_scale – devolve o tamanho da escala de uma coluna
    int tsql_field_length(pointer id_resultado, int coluna);
    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.
    coluna : número da coluna do conjunto resultado(a partir de zero)
    retorna tamanho da escala da coluna ou –1 se erro
    A escala de uma coluna DECIMAL corresponde ao número máximo de dígitos a direita do ponto decimal. Para os outros tipos, a escala não é uma informação relevante.

    13) tsql_free_result - libera recursos de um conjunto resultado
    int tsql_free_result ( pointer id_resultado )
    id_resultado : identificador de um conjunto resultado
    retorna sempre 1

    14) tsql_commit – fecha uma transação
    int tsql_commit(pointer id_connexão);
    id_conexão : identificador de conexão.
    retorna 0 se sucesso, e -1 se erro.
    O mesmo efeito pode ser obtido com a execução do commando SQL, “COMMIT_WORK”. O tempo de execução de tsql_commit é um pouco menor, tendo em vista que não é necessário compilar um commando SQL, e pode se justificar em um ambiente de muitas transações em paralelo.

    15) tsql_rollback – desfaz uma transação
    int tsql_rollback(pointer id_conexão);
    id_conexão : identificador de conexão.
    retorna 0 se sucesso, e -1 se erro.
    O mesmo efeito pode ser obtido com a execução do commando SQL, ROLLBACK_WORK. O tempo de execução de tsql_rollback é um pouco menor, tendo em vista que não é necessário compilar um comandoSQL, e pode se justificar em um ambiente de muitas transações em paralelo.

    16) tsql_last_error – Devolve a última mensagem de erro produzida
    int tsql_last_error(cadeia erro);
    retorna um cadeia contendo a última mensagem de erro gerada .
    Se não houve erro uma cadeia vazia é retornado

     



       

     



    Banco de Dados Relacional OpenBase - Rua Teotonio Rregadas, 26 - 5º Andar - Sala 501 - Lapa - Rio de Janeiro