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





  •  

    SQL - PHP
     
    Interface PHP - TSQL
     
     

    Utilizando a biblioteca php_tsql.so é possível executar query's do PHP em uma base de dados OpenBase.
    Veja a baixo as funções:


    tsql_connect - Abre uma conexão
    Descrição:
    resource tsql_connect (string conexão, string usuário, string password)
    retorna uma identificação de conexão do tipo resource ou FALSE se erro.

    conexão : string do tipo “HST=…;DSN=…;UID=…;PWD=….;etc…”
    usuário : corresponde à palavra de nível.
    password : corresponde ao código de segurança

    Se no string de 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.)

    tsql_close - Termina uma conexão
    Descrição:
    bool tsql_close ( resource id_conexão)
    retorna TRUE se sucesso, FALSE se erro.

    id_conexão : identificação da conexão do tipo resource

    tsql_query - executa um commando SQL
    Descrição:
    resource tsql_exec( resource id_conexão, string query)
    retorna uma identificação de resultado do tipo resource ou FALSE se erro

    id_conexão : identificação de uma conexão aberta
    query : texto do commando SQL

    tsql_fetch_row - lê a proxima linha de um conjunto resultado em um vetor numéricamente indexado.
    Descrição:
    array tsql_fetch_row( resource id_resultado )
    retorna um array numérico se existe a linha, senão retorna FALSE

    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL do tipo SELECT.

    tsql_fetch_row retorna a próxima linha de um conjunto resultado . Cada coluna é armazenada numa célula de uma array. O primeiro índice é igual a zero.


    tsql_fetch_assoc – lê a proxima linha de um conjunto resultado em um vetor associativo
    Descrição:
    array tsql_fetch_assoc(resouce id_resultado)
    retorna um array associativo se existe a linha, senão retorna FALSE.

    id_resultado : identificador de resultado devolvido por uma chamada
    tsql_query para um commando SQL do tipo SELECT.

    Assim como a função tsql_fetch_row, tsql_fetch_assoc lê a próxima linha, com a diferença que cada coluna é armazenada numa célula de um array que é indexado pelo nome da coluna ao invés da posição da coluna.


    tsql_num_fields - devolve o número de colunas de uma linha
    Descrição:
    int tsql_num_fields ( resource id_resultado);
    retorna número de colunas ou FALSE se erro.

    id_resultado : identificador de resultado devolvido por uma chamada tsql_query .


    Se o número de colunas retornados for igual a zero, o commando SQL executado, não é um commando SELECT.


    tsql_affected_rows – número de linhas alteradas
    Descrição :
    int tsql_affected_rows(resource id_resultado);
    retorna número de linhas alteradas ou FALSE se erro

    id_resultado : identificador de resultado devolvido por uma chamada tsql_query para um commando SQL .


    A função se aplica para os commandos SQL que alteram dados como INSERT, DELETE e UPDATE.


    tsql_field_name – devolve o nome de uma coluna
    Descrição:
    string tsql_field_name(resource id_resultado, int coluna);
    retorna nome da coluna ou FALSE se erro

    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)


    tsql_field_type – devolve o tipo de uma coluna
    Descrição:
    string tsql_field_type(resource id_resultado, int coluna);
    retorna nome da coluna ou FALSE se erro

    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)


    tsql_field_length – devolve o tamanho interno de uma coluna
    Descrição:
    int tsql_field_length(resource id_resultado, int coluna);
    retorna tamanho da coluna ou FALSE se erro

    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)

    O tamanho interno equivale ao número de bytes que é retornado à uma aplicação.

    tsql_field_displen – devolve o tamanho de exibição de uma coluna
    Descrição:
    int tsql_field_length(resource id_resultado, int coluna);
    retorna tamanho da coluna ou FALSE se erro

    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)

    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.


    tsql_field_scale – devolve o tamanho da escala de uma coluna
    Descrição:
    int tsql_field_length(resource id_resultado, int coluna);
    retorna tamanho da escala da coluna ou FALSE se erro

    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)

    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.


    tsql_free_result - libera recursos de um conjunto resultado
    Descrição:
    bool free_result ( resource id_resultado )
    retorna sempre TRUE

    id_resultado : identificador de um conjunto resultado


    tsql_commit – fecha uma transação
    Descrição:
    bool tsql_commit(resource id_connexão);
    retorna TRUE se sucesso, e FALSE se erro.

    id_conexão : identificador de conexão.

    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.


    tsql_rollback – desfaz uma transação
    Descrição:
    bool tsql_rollback(resource id_conexão);
    retorna TRUE se sucesso, e FALSE se erro.

    id_conexão : identificador de conexão.

    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.

    tsql_last_error – Devolve a última mensagem de erro produzida
    Descrição:
    string tsql_last_error();
    retorna um string contendo a última mensagem de erro gerada . Se não houve erro, uma mensagem vazia é retornada.

     



     



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