Funções PostgreSQL
Notas
Note:
Nem todas as funções são suportadas por todas as compilações. Isso vai depender da versão da libpq (A interface cliente em C para PostgreSQL) e como esta foi compilada. Se há alguma função ausente, é porque a libpq não suporta a característica exigida por esta função.
Note:
A maioria das funções do PostgreSQL aceita
connection
como o primeiro parâmetro opcional. Se ele não é fornecido, a última conexão aberta é usada. Se não existir, a função retornafalse
.
Note:
PostgreSQL automaticamente converte todos identificadores (e.g. nomes de tabela/coluna) para minúsculo na criação do objeto e na query. Para força o uso misto de maiúsculo ou minúsculo, você precisa usar escape no identificador usando aspas dupla ("").
Note:
PostgreSQL não tem comandos especiais para obter informação dos dados do banco de dados (dicionário de dados) (eg. todas as tabelas do banco de dados atual). Ao invés, há um schema padrão chamado
information_schema
no PostgreSQL 7.4 e superior contendo views do sistema com todas as informações necessárias, em um form fácil de acessá-las. Veja a » Documentação do PostgreSQL para maiores detalhes.
Table of Contents
- 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 — Procura 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_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_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)