postgres - Online na nuvem

PROGRAMA:

NOME

postgres - servidor de banco de dados PostgreSQL

SINOPSE

postgres [opção...]

DESCRIÇÃO

postgres é o servidor de banco de dados PostgreSQL. Para que um aplicativo cliente acesse um
banco de dados que ele conecta (através de uma rede ou localmente) a um postgres instância. O
postgres a instância então inicia um processo de servidor separado para lidar com a conexão.

completa postgres instância sempre gerencia os dados de exatamente um cluster de banco de dados. Um banco de dados
cluster é uma coleção de bancos de dados armazenados em um local comum do sistema de arquivos (o
“Área de dados”). Mais de um postgres instância pode ser executada em um sistema ao mesmo tempo, desde que
eles usam diferentes áreas de dados e diferentes portas de comunicação (veja abaixo). Quando postgres
começa precisa saber a localização da área de dados. O local deve ser especificado por
da -D opção ou o PGDATA variável de ambiente; não há padrão. Tipicamente, -D or
PGDATA aponta diretamente para o diretório da área de dados criado por banco de dados de inicialização(1). Outros possiveis
os layouts dos arquivos são discutidos na Seção 18.2, “Locais dos arquivos”, na documentação.

Por padrão postgres começa em primeiro plano e imprime mensagens de log com o erro padrão
Stream. Em aplicações práticas postgres deve ser iniciado como um processo em segundo plano,
talvez na hora da inicialização.

A postgres comando também pode ser chamado no modo de usuário único. O principal uso para este modo
é durante a inicialização por banco de dados de inicialização(1). Às vezes, é usado para depuração ou desastre
recuperação; observe que executar um servidor de usuário único não é realmente adequado para depurar o
servidor, uma vez que nenhuma comunicação entre processos realistas e travamento ocorrerá. Quando
invocado no modo de usuário único do shell, o usuário pode inserir consultas e os resultados
será impresso na tela, mas de uma forma que seja mais útil para os desenvolvedores do que final
Comercial. No modo de usuário único, o usuário da sessão será definido como o usuário com ID 1, e
poderes implícitos de superusuário são concedidos a este usuário. Este usuário não precisa realmente
existem, então o modo de usuário único pode ser usado para recuperar manualmente de certos tipos de
danos acidentais aos catálogos do sistema.

OPÇÕES

postgres aceita os seguintes argumentos de linha de comando. Para uma discussão detalhada do
opções, consulte o Capítulo 18, Configuração do servidor, na documentação. Você pode salvar
digitando a maioria dessas opções definindo um arquivo de configuração. Algumas opções (seguras) podem
também pode ser definido a partir do cliente conectado de uma maneira dependente do aplicativo para aplicar apenas para
essa sessão. Por exemplo, se a variável de ambiente PGOPÇÕES é definido, então baseado em libpq
os clientes passarão essa string para o servidor, que a interpretará como postgres
opções de linha de comando.

Geral Propósito
-B buffers
Define o número de buffers compartilhados para uso pelos processos do servidor. O valor padrão
deste parâmetro é escolhido automaticamente pelo initdb. Especificar esta opção é
equivalente a definir o parâmetro de configuração shared_buffers.

-c nome=valor
Define um parâmetro de tempo de execução nomeado. Os parâmetros de configuração suportados pelo PostgreSQL
são descritos no Capítulo 18, Configuração do servidor, na documentação. A maioria dos
outras opções de linha de comando são, na verdade, formas abreviadas de atribuição de parâmetro. -c
pode aparecer várias vezes para definir vários parâmetros.

-C nome
Imprime o valor do parâmetro de tempo de execução nomeado e sai. (Veja o -c opção acima
para obter detalhes.) Isso pode ser usado em um servidor em execução e retorna valores de
postgresql.conf, modificado por quaisquer parâmetros fornecidos nesta chamada. Isso não
refletem os parâmetros fornecidos quando o cluster foi iniciado.

Esta opção se destina a outros programas que interagem com uma instância do servidor, como
pg_ctl(1), para consultar os valores dos parâmetros de configuração. Os aplicativos voltados para o usuário devem
ao invés use MOSTRA(7) ou a visão pg_settings.

-d nível de depuração
Define o nível de depuração. Quanto mais alto este valor for definido, maior será a saída de depuração
escrito no log do servidor. Os valores vão de 1 a 5. Também é possível passar -d 0
para uma sessão específica, o que impedirá o nível de log do servidor do pai postgres
processo seja propagado para esta sessão.

-D diretório de dados
Especifica a localização do sistema de arquivos dos arquivos de configuração do banco de dados. Veja a seção
18.2, “Locais dos arquivos”, na documentação para obter detalhes.

-e
Define o estilo de data padrão como “Europeu”, ou seja, a ordem DMY dos campos de data de entrada.
Isso também faz com que o dia seja impresso antes do mês em determinada saída de data
formatos. Consulte a Seção 8.5, “Tipos de data / hora” na documentação para mais
informações.

-F
Desativa fsync apela para um melhor desempenho, sob o risco de corrupção de dados no
caso de uma falha do sistema. Especificar esta opção é equivalente a desativar o fsync
parâmetro de configuração. Leia a documentação detalhada antes de usar isso!

-h hostname
Especifica o nome do host IP ou endereço no qual postgres é ouvir TCP / IP
conexões de aplicativos cliente. O valor também pode ser uma lista separada por vírgulas de
endereços, ou * para especificar a escuta em todas as interfaces disponíveis. Um valor vazio
especifica a não escuta em nenhum endereço IP, caso em que apenas soquetes de domínio Unix
pode ser usado para se conectar ao servidor. O padrão é escutar apenas no host local.
Especificar esta opção é equivalente a definir a configuração de listen_addresses
parâmetro.

-i
Permite que clientes remotos se conectem por meio de conexões TCP / IP (domínio da Internet). Sem
esta opção, apenas conexões locais são aceitas. Esta opção é equivalente à configuração
endereços_de_escuta para * em postgresql.conf ou via -h.

Esta opção está obsoleta, pois não permite o acesso a todas as funcionalidades do
listen_addresses. Geralmente é melhor definir endereços_de_escuta diretamente.

-k anuário
Especifica o diretório do soquete do domínio Unix no qual postgres é ouvir
conexões de aplicativos cliente. O valor também pode ser uma lista separada por vírgulas de
diretórios. Um valor vazio especifica a não escuta em nenhum soquete de domínio Unix, em
caso em que apenas soquetes TCP / IP podem ser usados ​​para se conectar ao servidor. O valor padrão
é normalmente / Tmp, mas isso pode ser alterado no momento da construção. Especificar esta opção é
equivalente a definir o parâmetro de configuração unix_socket_directories.

-l
Habilita conexões seguras usando SSL. PostgreSQL deve ter sido compilado com suporte
para SSL para que esta opção esteja disponível. Para obter mais informações sobre o uso de SSL, consulte
Seção 17.9, “Conexões TCP / IP seguras com SSL”, na documentação.

-N conexões máximas
Define o número máximo de conexões de cliente que este servidor aceitará. O
o valor padrão deste parâmetro é escolhido automaticamente pelo initdb. Especificando isto
opção é equivalente a definir o parâmetro de configuração max_connections.

-o opções extras
Os argumentos de estilo de linha de comando especificados em opções extras são passados ​​para todos os servidores
processos iniciados por este postgres processo.

Espaços dentro opções extras são considerados argumentos separados, a menos que escapados com
uma barra invertida (\); escreva \\ para representar uma barra invertida literal. Vários argumentos podem
também pode ser especificado por meio de vários usos de -o.

O uso desta opção é obsoleto; todas as opções de linha de comando para processos de servidor podem
ser especificado diretamente no postgres linha de comando.

-p porta
Especifica a porta TCP / IP ou extensão de arquivo de soquete de domínio Unix local em que postgres
é ouvir conexões de aplicativos clientes. O padrão é o valor de
PGPORT variável de ambiente, ou se PGPORT não está definido, o padrão é o valor
estabelecido durante a compilação (normalmente 5432). Se você especificar uma porta diferente de
porta padrão, todos os aplicativos cliente devem especificar a mesma porta usando um
opções de linha de comando ou PGPORT.

-s
Imprima informações de tempo e outras estatísticas no final de cada comando. Isso é útil
para benchmarking ou para uso no ajuste do número de buffers.

-S trabalho-mem
Especifica a quantidade de memória a ser usada por classificações internas e hashes antes
recorrendo a arquivos de disco temporários. Veja a descrição do trabalho_mem • Configuração
parâmetro na Seção 18.4.1, “Memória”, na documentação.

-V
--versão
Imprima a versão do postgres e saia.

--nome=valor
Define um parâmetro de tempo de execução nomeado; uma forma mais curta de -c.

--descrever-config
Esta opção descarta as variáveis ​​de configuração interna do servidor, descrições e
padrões em delimitado por tabulação CÓPIA formato. É projetado principalmente para uso por
ferramentas de administração.

-?
--Socorro
Mostre a ajuda sobre os argumentos da linha de comando do postgres e saia.

Semi-interno Opções
As opções descritas aqui são usadas principalmente para fins de depuração e, em alguns casos, para
auxiliar na recuperação de bancos de dados gravemente danificados. Não deve haver razão para usá-los
em uma configuração de banco de dados de produção. Eles estão listados aqui apenas para uso pelo sistema PostgreSQL
desenvolvedores. Além disso, essas opções podem ser alteradas ou removidas em uma versão futura
sem aviso prévio.

-f {s | eu | o | b | t | n | m | h}
Proíbe o uso de métodos específicos de verificação e junção: s e i desativam sequencial e
varreduras de índice, respectivamente, o, be t desabilitam varreduras apenas de índice, varreduras de índice de bitmap e
O TID verifica respectivamente, enquanto n, m e h desabilitam o loop aninhado, mesclagem e junções de hash
respectivamente.

Nem as varreduras sequenciais nem as junções de loop aninhado podem ser desabilitadas completamente; o -fs e
As opções -fn simplesmente desencorajam o otimizador de usar esses tipos de plano se houver algum
outra alternativa.

-n
Esta opção serve para depurar problemas que fazem com que um processo do servidor seja interrompido de maneira anormal.
A estratégia comum nesta situação é notificar todos os outros processos do servidor que
eles devem terminar e, em seguida, reinicializar a memória compartilhada e os semáforos. Isto é
porque um processo errante do servidor pode ter corrompido algum estado compartilhado antes
encerrando. Esta opção especifica que postgres não reinicializará os dados compartilhados
estruturas. Um programador de sistema experiente pode então usar um depurador para examinar
memória compartilhada e estado do semáforo.

-O
Permite que a estrutura das tabelas do sistema seja modificada. Isso é usado por banco de dados de inicialização.

-P
Ignora os índices do sistema ao ler as tabelas do sistema, mas ainda atualiza os índices quando
modificando as tabelas. Isso é útil na recuperação de índices de sistema danificados.

-t pa [rser] | pl [anner] | executor]
Imprima estatísticas de tempo para cada consulta relacionada a cada um dos principais módulos do sistema.
Esta opção não pode ser usada junto com o -s opção.

-T
Esta opção serve para depurar problemas que fazem com que um processo do servidor seja interrompido de maneira anormal.
A estratégia comum nesta situação é notificar todos os outros processos do servidor que
eles devem terminar e, em seguida, reinicializar a memória compartilhada e os semáforos. Isto é
porque um processo errante do servidor pode ter corrompido algum estado compartilhado antes
encerrando. Esta opção especifica que postgres irá parar todos os outros processos do servidor
enviando o sinal SIGSTOP, mas não fará com que sejam encerrados. Isso permite
programadores de sistema para coletar core dumps de todos os processos do servidor manualmente.

-v protocolo
Especifica o número da versão do protocolo frontend / backend a ser usado para um
sessão particular. Esta opção é apenas para uso interno.

-W segundo
Um atraso de muitos segundos ocorre quando um novo processo do servidor é iniciado, após ele
conduz o procedimento de autenticação. O objetivo é dar uma oportunidade para
anexar ao processo do servidor com um depurador.

Opções for Único usuário Moda
As opções a seguir se aplicam apenas ao modo de usuário único.

--solteiro
Seleciona o modo de usuário único. Este deve ser o primeiro argumento na linha de comando.

banco de dados
Especifica o nome do banco de dados a ser acessado. Este deve ser o último argumento em
a linha de comando. Se for omitido, o padrão é o nome do usuário.

-E
Ecoe todos os comandos.

-j
Desativa o uso de nova linha como um delimitador de instrução.

-r nome do arquivo
Envie toda a saída de log do servidor para nome do arquivo. Esta opção só é honrada quando fornecida como um
opção de linha de comando.

MEIO AMBIENTE

CODIFICAÇÃO PGCLIENTE
Codificação de caracteres padrão usada por clientes. (Os clientes podem substituir isso
individualmente.) Este valor também pode ser definido no arquivo de configuração.

PGDATA
Localização do diretório de dados padrão

PGDATESTYLE
Valor padrão do parâmetro de tempo de execução DateStyle. (O uso deste ambiente
variável está obsoleta.)

PGPORT
Número da porta padrão (de preferência definido no arquivo de configuração)

TZ
Fuso horário do servidor

DIAGNÓSTICO

Uma mensagem de falha mencionando semget ou shmget provavelmente indica que você precisa configurar
seu kernel para fornecer memória compartilhada adequada e semáforos. Para mais discussão veja
Seção 17.4, “Gerenciando recursos do Kernel”, na documentação. Você pode ser capaz de
adie a reconfiguração de seu kernel diminuindo shared_buffers para reduzir o compartilhamento
consumo de memória do PostgreSQL, e / ou reduzindo max_connections para reduzir o
consumo de semáforo.

Uma mensagem de falha sugerindo que outro servidor já está em execução deve ser verificada
com cuidado, por exemplo, usando o comando

$ ps ax | grep postgres

or

$ ps -E se | grep postgres

dependendo do seu sistema. Se tiver certeza de que nenhum servidor conflitante está em execução, você
pode remover o arquivo de bloqueio mencionado na mensagem e tentar novamente.

Uma mensagem de falha indicando a incapacidade de se ligar a uma porta pode indicar que essa porta é
já em uso por algum processo não PostgreSQL. Você também pode obter este erro se
terminar postgres e reinicie-o imediatamente usando a mesma porta; neste caso, você deve
simplesmente espere alguns segundos até que o sistema operacional feche a porta antes de tentar novamente.
Finalmente, você pode obter este erro se especificar um número de porta que seu sistema operacional
considera ser reservado. Por exemplo, muitas versões do Unix consideram os números de porta sob
1024 para serem “confiáveis” e permitir apenas que o superusuário do Unix os acesse.

NOTAS

O comando utilitário pg_ctl(1) pode ser usado para iniciar e desligar o postgres servidor
com segurança e conforto.

Se tudo for possível, do não use SIGKILL para matar o principal postgres servidor. Fazer isso vai
evitar postgres de liberar os recursos do sistema (por exemplo, memória compartilhada e semáforos)
que mantém antes de encerrar. Isso pode causar problemas para iniciar um novo postgres
executar.

Para encerrar o postgres servidor normalmente, os sinais SIGTERM, SIGINT ou SIGQUIT podem ser
usava. O primeiro irá esperar que todos os clientes encerrem antes de sair, o segundo irá
forçosamente desconecte todos os clientes, e o terceiro irá encerrar imediatamente sem o devido
desligamento, resultando em uma execução de recuperação durante a reinicialização.

O sinal SIGHUP irá recarregar os arquivos de configuração do servidor. Também é possível enviar
SIGHUP para um processo de servidor individual, mas isso geralmente não é sensato.

Para cancelar uma consulta em execução, envie o sinal SIGINT para o processo que está executando aquele comando. Para
encerre um processo de back-end de forma limpa, envie SIGTERM para esse processo. Veja também
pg_cancel_backend e pg_terminate_backend na Seção 9.26.2, “Sinalização de servidor
Functions ”, na documentação para os equivalentes que podem ser chamados por SQL dessas duas ações.

A postgres servidor usa SIGQUIT para dizer aos processos subordinados do servidor para terminar sem
limpeza normal. Este sinal rede de apoio social não ser usado pelos usuários. Também não é aconselhável enviar SIGKILL
para um processo de servidor - o principal postgres processo irá interpretar isso como um travamento e
forçar o encerramento de todos os processos irmãos como parte do procedimento padrão de recuperação de falhas.

Use postgres online usando serviços onworks.net