Funções PostgreSQL

Índice

• pg_affected_rows — Retorna o número de registros afetados (tuplas)
• pg_cancel_query — Cancela uma consulta assíncrona
• pg_client_encoding — Obtém a codificação do cliente
• pg_close — Fecha uma conexão PostgreSQL
• pg_connect — Abre uma conexão PostgreSQL
• pg_connect_poll — Pesquisa o status de uma tentativa de conexão PostgreSQL assíncrona em andamento
• pg_connection_busy — Obtém se conexão está ocupada ou não
• pg_connection_reset — Redefine conexão (reconecta)
• pg_connection_status — Obtém o status da conexão
• pg_consume_input — Lê a entrada na conexão
• pg_convert — Converte valores de array associativo em formas adequadas para instruções SQL
• pg_copy_from — Insere registros em uma tabela a partir de um array
• pg_copy_to — Copia uma tabela para um array
• pg_dbname — Obtém o nome do banco de dados
• pg_delete — Exclui registros
• pg_end_copy — Sincroniza com back-end do PostgreSQL
• pg_escape_bytea — Escapa uma string para inserção em um campo bytea
• pg_escape_identifier — Escapa um identificador para inserção em um campo de texto
• pg_escape_literal — Escapa um literal para inserção em um campo de texto
• pg_escape_string — Escapa uma string para consulta
• pg_execute — Envia uma solicitação para executar uma instrução preparada com determinados parâmetros e aguarda o resultado
• pg_fetch_all — Busca todas as linhas de um resultado como um array
• pg_fetch_all_columns — Busca todas as linhas em uma determinada coluna de resultado como um array
• pg_fetch_array — Busca uma linha como um array
• pg_fetch_assoc — Busca uma linha como um array associativo
• pg_fetch_object — Busca uma linha como um objeto
• pg_fetch_result — Retorna valores de uma instância de resultado
• pg_fetch_row — Obtém uma linha como um array enumerado
• pg_field_is_null — Testa se um campo é SQL NULL
• pg_field_name — Retorna o nome de um campo
• pg_field_num — Retorna o número do campo para o campo nomeado
• pg_field_prtlen — Retorna o comprimento impresso
• pg_field_size — Retorna o tamanho de armazenamento interno do campo nomeado
• pg_field_table — Retorna o nome ou oid do campo da tabela
• pg_field_type — Retorna o nome do tipo para o número do campo correspondente
• pg_field_type_oid — Retorna o ID do tipo (OID) para o número do campo correspondente
• pg_flush — Libera dados de consulta de saída na conexão
• pg_free_result — Libera memória de resultados
• pg_get_notify — Obtém mensagem SQL NOTIFY
• pg_get_pid — Obtém o ID do processo do backend
• pg_get_result — Obtém o resultado da consulta assíncrona
• pg_host — Retorna o nome do host associado à conexão
• pg_insert — Insere array na tabela
• pg_last_error — Obtém a última string da mensagem de erro de uma conexão
• pg_last_notice — Retorna a última mensagem de aviso do servidor PostgreSQL
• pg_last_oid — Retorna o OID da última linha
• pg_lo_close — Fecha um objeto grande
• pg_lo_create — Cria um objeto grande
• pg_lo_export — Exporta um objeto grande para arquivo
• pg_lo_import — Importa um objeto grande do arquivo
• pg_lo_open — Abra um objeto grande
• pg_lo_read — Lê um objeto grande
• pg_lo_read_all — Lê um objeto grande inteiro e envia direto para o navegador
• pg_lo_seek — Aponta para posição dentro de um objeto grande
• pg_lo_tell — Retorna a posição de busca atual a de um objeto grande
• pg_lo_truncate — Trunca um objeto grande
• pg_lo_unlink — Exclui um objeto grande
• pg_lo_write — Escreve em um objeto grande
• pg_meta_data — Obtém metadados para tabela
• pg_num_fields — Retorna o número de campos em um resultado
• pg_num_rows — Retorna o número de linhas em um resultado
• pg_options — Obtém as opções associadas à conexão
• pg_parameter_status — Procura uma configuração de parâmetro atual do servidor
• pg_pconnect — Abre uma conexão PostgreSQL persistente
• pg_ping — Ping em conexão com banco de dados
• pg_port — Retorne o número da porta associada à conexão
• pg_prepare — Envia uma solicitação ao servidor para criar uma instrução preparada com os parâmetros fornecidos e aguarda a conclusão
• pg_put_line — Envia uma string terminada em NULL para o backend do PostgreSQL
• pg_query — Executa uma consulta
• pg_query_params — Envia um comando ao servidor e aguarda o resultado, com a capacidade de passar parâmetros separadamente do texto do comando SQL
• pg_result_error — Obtém mensagem de erro associada ao resultado
• pg_result_error_field — Retorna um campo individual de um relatório de erros
• pg_result_memory_size — Retorna a quantidade de memória alocada para um resultado de consulta
• pg_result_seek — Define deslocamento interno de linha na instância de resultado
• pg_result_status — Obtém o status do resultado da consulta
• pg_select — Seleciona registros
• pg_send_execute — Envia uma solicitação para executar uma instrução preparada com determinados parâmetros, sem esperar pelo(s) resultado(s)
• pg_send_prepare — Envia uma solicitação para criar uma instrução preparada com os parâmetros fornecidos, sem esperar pela conclusão
• pg_send_query — Envia consulta assíncrona
• pg_send_query_params — Envia um comando e parâmetros separados para o servidor sem esperar pelo(s) resultado(s)
• pg_set_chunked_rows_size — Define que os resultados da consulta sejam retornados em partes
• pg_set_client_encoding — Define a codificação do cliente
• pg_set_error_context_visibility — Determina a visibilidade das mensagens de erro do contexto retornadas por pg_last_error e pg_result_error
• pg_set_error_verbosity — Determina o detalhamento das mensagens retornadas por pg_last_error e pg_result_error
• pg_socket — Obtém um identificador somente leitura para o socket subjacente a uma conexão PostgreSQL
• pg_trace — Ativa o rastreamento de uma conexão PostgreSQL
• pg_transaction_status — Retorna o status atual da transação do servidor
• pg_tty — Retorna o nome TTY associado à conexão
• pg_unescape_bytea — Desfaz escape binário para tipo bytea
• pg_untrace — Desabilita o rastreamento de uma conexão PostgreSQL
• pg_update — Atualiza tabela
• pg_version — Retorna um array com versão do cliente, protocolo e servidor (quando disponível)

A simple conversion for 1D PostgreSQL array data:

// =====
//Example #1 (An array of IP addresses):
<?php
  $pgsqlArr = '{192.168.1.1,10.1.1.1}';

  preg_match('/^{(.*)}$/', $pgsqlArr, $matches);
  $phpArr = str_getcsv($matches[1]);

  print_r($phpArr);
}
// Output:
// Array
// (
//    [0] => 192.168.1.1
//    [1] => 10.1.1.1
// )
// =====

// =====
// Example #2 (An array of strings including spaces and commas):
<?php
  $pgsqlArr = '{string1,string2,"string,3","string 4"}';

  preg_match('/^{(.*)}$/', $pgsqlArr, $matches);
  $phpArr = str_getcsv($matches[1]);

  print_r($phpArr);
}
// Output:
// Array
// (
//    [0] => string1
//    [1] => string2
//    [2] => string,3
//    [3] => string 4
// )
// =====

I've found another function to mimic the following mysql list tables function (http://www.php.net/manual/en/function.mysql-list-tables.php) that's more useful for my target:

function pg_list_tables() {
      $sql = "SELECT a.relname AS Name
          FROM pg_class a, pg_user b
          WHERE ( relkind = 'r') and relname !~ '^pg_' AND relname !~ '^sql_'
          AND relname !~ '^xin[vx][0-9]+' AND b.usesysid = a.relowner
          AND NOT (EXISTS (SELECT viewname FROM pg_views WHERE viewname=a.relname));";
      return(pg_query($conn, $sql));
}

Running RedHat Linux and Apache with suexec enabled you must include pgsql.so on each .php file using dl("pgsql.so") and remove "extension=pgsql.so" from php.ini, otherwise Apache (httpd) will not start.