Especifica o nome do banco de dados a ser exportado. Se não for especificado, será usada a variável de ambiente PGDATABASE. Se esta variável não estiver definida, será usado o nome de usuário especificado para a conexão.

Exporta somente os dados, não exporta o esquema (definições de dados). Os dados das tabelas, objetos grandes e valores de sequência são incluídos.

Esta opção é semelhante, mas não idêntica por razões históricas, a especificar --section=data.

Inclui objetos grandes na exportação. Este é o comportamento padrão, exceto quando é especificado --schema, --table ou --schema-only. A opção -b é, portanto, útil apenas para adicionar objetos grandes a exportações onde foi especificado um determinado esquema ou tabela. Note que os objetos grandes binários (blobs) são considerados dados e, portanto, serão incluídos quando for usada a opção --data-only, mas não quando for usada a opção --schema-only.

Exclui os objetos grandes da exportação.

Quando são especificadas as duas opções -b e -B, o comportamento é incluir os objetos grandes quando os dados estão sendo exportados. Veja a documentação de -b .

Gera comandos para excluir (DROP) todos os objetos de banco de dados exportados antes de gerar os comandos para criá-los. Esta opção é útil quando a importação envolve a sobrescrita de um banco de dados existente. Se algum dos objetos não existir no banco de dados de destino, ​​ serão mostradas mensagens de erro ignoráveis durante a importação, a menos que também seja especificada a opção --if-exists.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Começa a saída com um comando para criar o próprio banco de dados, e reconectar ao banco de dados criado. (Com um script assim não importa em que banco de dados na instalação de destino se está conectado antes de executar o script.) Se também for especificada a opção --clean, o script exclui e recria o banco de dados de destino antes de se reconectar a ele.

Com a opção --create, a saída também inclui o comentário do banco de dados, se houver, e quaisquer definições de variáveis de configuração que sejam específicas para este banco de dados, ou seja, qualquer comando ALTER DATABASE ... SET ... e ALTER ROLE ... IN DATABASE ... SET ... que mencione este banco de dados. Os privilégios de acesso para o próprio banco de dados também são exportados, a menos que seja especificada a opção --no-acl.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Exporta apenas as extensões que correspondem ao padrão. Quando esta opção não for especificada, serão exportadas todas as extensões no banco de dados de destino que não são do sistema. Podem ser selecionadas várias extensões escrevendo várias opções -e. O parâmetro padrão é interpretado segundo as mesmas regras usadas pelos comandos \d do psql (veja Padrões), assim, várias extensões também podem ser selecionadas escrevendo caracteres curinga no padrão. Ao usar caracteres curinga, deve-se ter o cuidado de delimitar o padrão, se necessário, para evitar que o interpretador de comandos expanda os curingas.

Qualquer relação de configuração registrada por pg_extension_config_dump será incluída na exportação se sua extensão for especificada por --extension.

Cria a exportação na codificação de conjunto de caracteres especificada. Por padrão, a exportação é criada na codificação do banco de dados. (Outra maneira de obter o mesmo resultado é definir a variável de ambiente PGCLIENTENCODING para a codificação de exportação desejada.) As codificações com suporte estão descritas em Conjuntos de caracteres com suporte.

Envia a saída para o arquivo especificado. Este parâmetro pode ser omitido para os formatos de saída baseados em arquivo, caso em que é usada a saída padrão. Entretanto, deve ser fornecido para o formato de saída de diretório, onde especifica o diretório de destino em vez de um arquivo. Neste caso, o diretório é criado por pg_dump, não devendo já existir.

Seleciona o formato da saída. O formato pode ser um dos seguintes:

Executa a exportação em paralelo exportando njobs tabelas simultaneamente. Esta opção pode reduzir o tempo necessário para realizar a exportação, mas também aumenta a carga no servidor de banco de dados. Esta opção só pode ser usada com o formato de saída diretório, porque este é o único formato de saída em que vários processos podem escrever seus dados ao mesmo tempo.

O pg_dump irá abrir njobs + 1 conexões com o servidor de banco de dados, portanto, deve-se ter certeza de que o parâmetro de configuração max_connections seja alto o suficiente para acomodar todas as conexões.

Solicitar bloqueios exclusivos em objetos de banco de dados durante a execução da exportação em paralelo pode fazer com que a exportação falhe. O motivo é que o processo líder pg_dump solicita bloqueios compartilhados (ACCESS SHARE) nos objetos que os processos trabalhadores irão exportar posteriormente, para garantir que ninguém os exclua e os faça desaparecer enquanto a exportação estiver em andamento. Se outro cliente solicitar um bloqueio exclusivo em uma tabela, este bloqueio não será concedido, mas ficará na fila aguardando a liberação do bloqueio compartilhado do processo líder. Consequentemente, qualquer outro acesso à tabela também não será concedido, ficando na fila após a solicitação do bloqueio exclusivo. Isto inclui o processo trabalhador que está tentando exportar a tabela. Sem quaisquer precauções, esta seria uma situação clássica de impasse (deadlock). Para detectar este conflito, o processo trabalhador pg_dump solicita outro bloqueio compartilhado usando a opção NOWAIT. Se o processo trabalhador não obtiver este bloqueio compartilhado, outra pessoa deve ter solicitado um bloqueio exclusivo neste meio tempo, não havendo como continuar com a exportação, então o pg_dump não tem escolha a não ser interromper a exportação.

Para realizar uma exportação em paralelo, o servidor de banco de dados precisa dar suporte a instantâneos sincronizados, um recurso introduzido na versão 9.2 do PostgreSQL para servidores primários, e na versão 10 para servidores em-espera (standby). Com este recurso, os clientes de banco de dados podem garantir que verão o mesmo conjunto de dados, mesmo usando conexões diferentes. A opção pg_dump -j usa várias conexões de banco de dados; se conecta ao banco de dados uma vez com o processo líder, e mais uma vez para cada processo trabalhador. Sem o recurso de instantâneo sincronizado, não seria garantido que os diferentes processos trabalhadores veriam os mesmos dados em cada conexão, o que poderia levar a uma exportação inconsistente.

Exporta apenas os esquemas que correspondem ao padrão; isto seleciona o próprio esquema e todos os objetos contidos nele. Quando esta opção não é especificada, são exportados todos os esquemas não pertencentes ao sistema no banco de dados de destino. Podem ser selecionados vários esquemas escrevendo várias opções -n. O parâmetro padrão é interpretado segundo as mesmas regras usadas pelos comandos \d do psql (veja Padrões), portanto, podem ser selecionados vários esquemas escrevendo caracteres curinga no padrão. Ao usar caracteres curinga, deve-se ter o cuidado de delimitar o padrão, se necessário, para evitar que o interpretador de comandos expanda os curingas; veja Exemplos abaixo.

Não exporta esquemas que correspondem ao padrão. O padrão é interpretado segundo as mesmas regras usadas para a opção -n. A opção -N pode ser usada mais de uma vez para excluir esquemas que correspondem a qualquer um dos vários padrões.

Quando são fornecidas as duas opções -n e -N, o comportamento é exportar apenas os esquemas que correspondem a pelo menos uma opção -n, mas não a nenhuma opção -N. Se for fornecida a opção -N, mas não a opção -n, os esquemas que correspondem a -N serão excluídos do que, de outra forma, seria uma exportação normal.

Não gera comandos para definir o dono dos objetos para corresponder ao banco de dados original. Por padrão, o pg_dump gera instruções ALTER OWNER ou SET SESSION AUTHORIZATION para definir o dono dos objetos de banco de dados criados. Estas instruções irão falhar quando o script for executado, a menos que seja executado por um superusuário (ou o mesmo usuário que possui todos os objetos no script). Para criar um script que permite a restauração por qualquer usuário, tornando este usuário o dono de todos os objetos, deve ser especificada a opção -O.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Esta opção está obsoleta, mas é ainda aceita para manter a compatibilidade com versões anteriores.

Exporta apenas as definições dos objetos (esquema), mas não os dados ou as estatísticas.

Esta opção não pode ser usada juntamente com as opções --data-only ou --statistics-only. Esta opção é semelhante, mas por razões históricas não é idêntica, a especificar --section=pre-data --section=post-data.

(Não confunda esta opção com a opção --schema, que usa a palavra “esquema” com um significado diferente.)

Para excluir dados de tabelas apenas para um subconjunto de tabelas no banco de dados, veja a opção --exclude-table-data.

Especifica o nome de usuário do superusuário a ser usado para desativar os gatilhos. Esta opção é relevante somente se também for usada a opção --disable-triggers. (Normalmente, é melhor não usar esta opção e, em vez disso, executar o script resultante como um superusuário.)

Exporta apenas as tabelas com nomes que correspondem ao padrão. Podem ser selecionadas várias tabelas escrevendo várias opções -t. O parâmetro padrão é interpretado segundo as mesmas regras usadas pelos comandos \d do psql (veja Padrões), assim várias tabelas também podem ser selecionadas escrevendo caracteres curinga no padrão. Ao usar caracteres curinga, deve-se ter o cuidado de delimitar o padrão, se necessário, para evitar que o interpretador de comandos expanda os curingas; veja Exemplos abaixo.

Assim como para as tabelas, esta opção pode ser usada para exportar a definição de visões, visões materializadas, tabelas estrangeiras e sequências correspondentes. Esta opção não exporta o conteúdo de visões ou visões materializadas, e o conteúdo de tabelas estrangeiras só será exportado se o servidor estrangeiro correspondente for especificado com a opção --include-foreign-data.

As opções -n e -N não têm efeito quando a opção -t é usada, porque as tabelas selecionadas por -t serão exportadas independentemente dessas opções, e os objetos que não são de tabela não serão exportados.

Não exporta nenhuma tabela que corresponda ao padrão. O padrão é interpretado segundo as mesmas regras usadas para a opção -t. A opção -T pode ser especificada mais de uma vez para excluir as tabelas que correspondem a qualquer um dos vários padrões.

Quando são especificadas as duas opções -t e -T, o comportamento é exportar apenas as tabelas que correspondem a pelo menos uma opção -t, mas não correspondem a nenhuma opção -T. Se for especificada a opção -T, mas não a opção -t, então as tabelas que correspondem a -T serão excluídas do que, de outra forma, seria uma exportação normal.

Especifica o modo verboso. Faz com que o pg_dumpall escreva as horas de início/fim no arquivo de exportação, e as mensagens de progresso na saída de erro padrão. e mensagens de progresso para a saída de erro padrão. Repetir a opção faz com que mensagens adicionais no nível de depuração apareçam na saída de erro padrão.

Mostra a versão do pg_dump e termina.

Impede a exportação dos privilégios de acesso (comandos GRANT/REVOKE).

Especifica o método de compressão e/ou o nível de compressão a ser usado. O método de compressão pode ser definido como gzip, lz4, zstd ou none para nenhuma compressão. Opcionalmente, pode-se especificar uma cadeia de caracteres contendo detalhes da compressão. Se a cadeia de caracteres de detalhes for um número inteiro, ela irá especificar o nível de compressão. Caso contrário, deve ser uma lista de itens separados por vírgulas, cada um com a forma palavra-chave ou palavra-chave=valor. No momento, as palavras-chave com suporte são level e long.

Se não for especificado nenhum nível de compressão, será usado o nível de compressão padrão. Se for especificado apenas o nível sem mencionar o algoritmo, então será usada a compressão gzip se o nível for maior que 0, e não será usada nenhuma compressão se o nível for 0.

Para os formatos de arquivo personalizado e diretório, esta opção especifica a compressão de segmentos individuais de dados de tabela, e o padrão é comprimir usando o gzip em um nível moderado. Para saída em texto-puro, definir um nível de compressão diferente de zero faz com que todo o arquivo de saída seja comprimido, como se tivesse sido processado pelo gzip, lz4 ou zstd; mas o padrão é não comprimir. Com a compressão zstd, o modo long pode melhorar a taxa de compressão, ao custo de maior uso de memória.

No momento o formato de arquivo tar não tem suporte para compressão.

Esta opção é para uso por utilitários de atualização in-loco. Seu uso para outros fins não é recomendado ou tem suporte. O comportamento dessa opção pode mudar em versões futuras sem aviso prévio.

Exporta os dados como comandos INSERT com nomes de coluna explícitos (INSERT INTO tabela (coluna, ...) VALUES ...). Isto torna a restauração muito lenta; serve principalmente para fazer exportações que podem ser importadas em bancos de dados não PostgreSQL. Qualquer erro ocorrido durante a restauração fará com que apenas as linhas que fazem parte do INSERT com problema sejam perdidas, em vez de todo o conteúdo da tabela.

Esta opção desativa o uso de delimitação por cifrão para corpos de função, forçando com que sejam delimitados usando a sintaxe de cadeia de caracteres do padrão SQL.

Esta opção é relevante apenas ao criar uma exportação que inclua os dados, mas não inclua o esquema. Ela instrui o pg_dump a incluir comandos para desativar temporariamente os gatilhos nas tabelas de destino enquanto os dados são restaurados. Deve ser usada se houver verificações de integridade referencial, ou outros gatilhos nas tabelas, que não se deseja chamar durante a restauração dos dados.

No momento, os comandos gerados para a opção --disable-triggers devem ser executados como superusuário. Portanto, também deve ser especificado um nome de superusuário com a opção -S ou, de preferência, ter o cuidado de executar o script gerado como um superusuário.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Esta opção é relevante apenas ao exportar o conteúdo de uma tabela que possui segurança de linha. Por padrão, pg_dump define row_security como desativado, para garantir que todos os dados da tabela sejam exportados. Se o usuário não tiver privilégios suficientes para ignorar a segurança de linha, será relatado um erro. Esta opção instrui o pg_dump a definir row_security como ativado, permitindo ao usuário exportar as partes do conteúdo da tabela à qual ele tem acesso.

Note que, no momento, se esta opção for usada provavelmente também irá se desejar que a exportação esteja no formato INSERT, porque o COPY FROM durante a restauração não oferece suporte à segurança de linha.

Não exporta nenhuma extensão que corresponda ao padrão. O padrão é interpretado segundo as mesmas regras da opção -e. A opção --exclude-extension pode ser fornecida mais de uma vez para excluir extensões que correspondem a qualquer um dos vários padrões.

Quando são fornecidas as duas opções -e e --exclude-extension, o comportamento consiste em exportar apenas as extensões que correspondem a pelo menos uma opção -e, mas não correspondem a nenhuma opção --exclude-extension. Se for fornecida a opção --exclude-extension, mas não a opção -e, então as extensões que correspondem à opção --exclude-extension serão excluídas do que, de outra forma, seria uma exportação normal.

Esta opção é semelhante à opção -T/--exclude-table, exceto por também excluir quaisquer partições ou tabelas filhas de herança da(s) tabela(s) que correspondem ao padrão.

Não exporta dados de nenhuma tabela que corresponda ao padrão. O padrão é interpretado segundo as mesmas regras usadas para a opção -t. A opção --exclude-table-data pode ser usada mais de uma vez para excluir tabelas que correspondem a qualquer um dos vários padrões. Esta opção é útil quando é necessária a definição de uma determinada tabela específica, mesmo que não se precise dos dados dela.

Para excluir dados de todas as tabelas do banco de dados, veja --schema-only ou --statistics-only.

Esta opção é semelhante à opção --exclude-table-data, exceto por também excluir dados de quaisquer partições ou tabelas filhas de herança da(s) tabela(s) que correspondem ao padrão.

Usa o valor especificado por extra_float_digits ao exportar os números de ponto flutuante, em vez da precisão máxima disponível. As exportações de rotina feitas para fins de cópia de segurança não devem usar esta opção.

Especifica um nome de arquivo a partir do qual serão lidos os padrões para objetos a serem incluídos ou excluídos da exportação. Os padrões são interpretados segundo as mesmas regras das opções correspondentes: -t/--table, --table-and-children, -T/--exclude-table e --exclude-table-and-children para tabelas, -n/--schema e -N/--exclude-schema para esquemas, --include-foreign-data para dados em servidores estrangeiros, --exclude-table-data e --exclude-table-data-and-children para dados de tabela, e -e/--extension e --exclude-extension para extensões. Para ler da STDIN deve ser usado - como nome do arquivo. A opção --filter pode ser especificada em conjunto com as opções listadas acima para incluir ou excluir objetos, e também pode ser especificado mais de uma vez para indicar vários arquivos de filtro.

O arquivo lista um padrão de objeto por linha, com o seguinte formato:

{ include | exclude } { extension
                      | foreign_data
                      | table
                      | table_and_children
                      | table_data
                      | table_data_and_children
                      | schema
                      } PADRÃO

A primeira palavra-chave especifica se os objetos que correspondem ao padrão devem ser incluídos ou excluídos. A segunda palavra-chave especifica o tipo de objeto a ser filtrado usando o padrão:

Linhas que começam com # são consideradas comentários e são ignoradas. Os comentários também podem ser colocados após uma linha de padrão de objeto. Linhas em branco também são ignoradas. Veja Padrões para saber como colocar delimitadores em padrões.

Os arquivos de exemplo estão listados abaixo na seção Exemplos.

Usa comandos DROP ... IF EXISTS para excluir objetos no modo --clean. Esta opção suprime erros do tipo “... não existe” que de outra forma poderiam ser relatados. Esta opção não é válida a menos que também seja especificada a opção --clean.

Exporta os dados de qualquer tabela estrangeira no servidor estrangeiro correspondente ao padrão servidor_estrangeiro. Podem ser selecionados vários servidores estrangeiros escrevendo a opção --include-foreign-data várias vezes. Além disso, o parâmetro servidor_estrangeiro é interpretado como um padrão segundo as mesmas regras usadas pelos comandos \d do psql (veja Padrões), portanto, também podem ser selecionados vários servidores estrangeiros escrevendo caracteres curinga no padrão. Ao usar caracteres curinga, deve-se ter o cuidado de delimitar o padrão, se necessário, para evitar que o interpretador de comandos expanda os curingas; veja Exemplos abaixo. A única exceção é que não é permitido um padrão vazio.

Exporta os dados como comandos INSERT (em vez de COPY). Isto torna a restauração muito lenta; serve principalmente para fazer exportações que podem ser importadas em bancos de dados não-PostgreSQL. Qualquer erro durante a restauração fará com que apenas as linhas que fazem parte do comando INSERT com problema sejam perdidas, em vez de todo o conteúdo da tabela. Note que a restauração poderá falhar inteiramente se a ordem das colunas das tabelas tiver sido reorganizada. A opção --column-inserts é segura contra alterações na ordem das colunas das tabelas, embora seja ainda mais lenta.

Ao exportar dados para uma partição de tabela, deve-se fazer com que as instruções COPY ou INSERT tenham como alvo a raiz da hierarquia de particionamento que os contém, em vez da própria partição. Isto faz com que seja redeterminada a partição apropriada para cada linha quando os dados são restaurados. Pode ser útil ao restaurar dados em um servidor onde as linhas nem sempre caem nas mesmas partições do servidor original. Isto poderá acontecer, por exemplo, se a coluna de particionamento for do tipo de dados texto e os dois sistemas tiverem definições diferentes de ordenação usada para classificar a coluna de particionamento.

Não aguarda para sempre para adquirir bloqueios de tabela compartilhada no início da exportação. Em vez disso, falha se não conseguir bloquear uma tabela dentro do tempo especificado por timeout. O tempo limite pode ser especificado em qualquer um dos formatos aceitos pelo comando SET statement_timeout. (Os formatos permitidos variam dependendo da versão do servidor onde está sendo feita a exportação, mas um número inteiro de milissegundos é aceito por todas as versões.)

Não exporta comandos COMMENT.

Não exporta dados.

Não exporta políticas de segurança de linha.

Não exporta publicações.

Não exporta esquemas (definições de dados).

Não exporta rótulos de segurança.

Não exporta estatísticas. Este é padrão.

Não exporta subscrições.

Por padrão, o pg_dump aguarda até que todos os arquivos sejam escritos com segurança no disco. Esta opção faz com que o pg_dump retorne sem aguardar, o que é mais rápido, mas significa que uma falha subsequente do sistema operacional pode deixar a exportação corrompida. Geralmente, esta opção é útil para testes, mas não deve ser usada ao exportar os dados de uma instalação de produção.

Não gera comandos para selecionar métodos de acesso à tabela. Com esta opção, todos os objetos serão criados com o método de acesso à tabela que for o padrão durante a importação.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Não gera comandos para selecionar os espaços de tabelas. Com esta opção, todos os objetos serão criados em qualquer espaço de tabelas que for o padrão durante a restauração.

Esta opção é ignorada ao gerar um arquivo de saída estruturado (não texto-puro). Para os formatos estruturados, pode-se especificar esta opção ao executar o utilitário pg_restore.

Não gera comandos de saída para definir os métodos de compressão TOAST. Com esta opção, todas as colunas serão restauradas com a configuração de compressão padrão.

Não exporta o conteúdo de tabelas sem registro de transações (unlogged). Esta opção não tem efeito sobre se as definições de tabela e sequência (esquema) serão ou não exportadas; esta opção apenas suprime a exportação dos dados da tabela e da sequência. Os dados em tabelas e sequências sem registro são sempre excluídos ao realizar uma exportação a partir de um servidor em-espera.

Adiciona a cláusula ON CONFLICT DO NOTHING nos comandos INSERT. Esta opção não é válida, a menos que também seja especificado --inserts, --column-inserts, ou --rows-per-insert.

Força a delimitação de todos os identificadores. Esta opção é recomendada ao exportar um banco de dados de um servidor cuja versão principal do PostgreSQL seja diferente da versão do pg_dump, ou quando a saída deve ser restaurada em um servidor com uma versão principal diferente. Por padrão, o pg_dump delimita apenas os identificadores que são palavras reservadas em sua própria versão principal. Às vezes, isto resulta em problemas de compatibilidade ao lidar com servidores de outras versões que podem ter conjuntos de palavras reservadas ligeiramente diferentes. Usar a opção --quote-all-identifiers evita estes problemas, ao custo de um script de exportação difícil de ler.

Usa a cadeia de caracteres fornecida como a chave \restrict do psql na saída da exportação. Só pode ser especificado para exportações de texto-puro, ou seja, quando --format é definido como plain ou a opção--format é omitida. Se não for especificada nenhuma chave de restrição, o pg_dump irá gerar uma chave aleatória conforme necessário. As chaves podem conter apenas caracteres alfanuméricos.

Esta opção destina-se principalmente a fins de teste e outros cenários que exigem resultados repetíveis (por exemplo, comparar arquivos de exportação). Não é recomendado para uso geral, porque um servidor maldoso com conhecimento prévio da chave pode ser capaz de injetar código arbitrário que será executado na máquina que irá executar o psql usando a saída da exportação.

Exporta os dados como comandos INSERT (em vez de COPY). Controla o número máximo de linhas por comando INSERT. O valor especificado deve ser um número maior que zero. Qualquer erro durante a restauração fará com que apenas as linhas que fazem parte do comando INSERT com problema sejam perdidas, em vez de todo o conteúdo da tabela.

Exporta apenas a seção indicada. O nome da seção pode ser pre-data, data, ou post-data. Esta opção pode ser especificada mais de uma vez para selecionar várias seções. O padrão é exportar todas as seções.

A seção de dados contém os dados reais das tabelas, o conteúdo de objetos grandes, os valores de sequência e as estatísticas para tabelas, visões materializadas e tabelas estrangeiras. Os itens de pós-dados incluem definições de índices, gatilhos, regras, estatísticas para índices e restrições que não sejam de verificação validade e restrições de não-nulo. Os itens de pré-dados incluem todos os outros itens de definição de dados.

Inclui os dados de sequência no arquivo de exportação. Este é o comportamento padrão, exceto quando é especificado. --no-data, --schema-only ou --statistics-only.

Usa uma transação serializável para a exportação, para garantir que o instantâneo usado seja consistente com os estados posteriores do banco de dados; mas faz isto esperando por um ponto no fluxo de transações em que nenhuma anomalia possa estar presente, de modo que não haja risco de falha na exportação ou causando a interrupção de outras transações com serialization_failure. Veja Controle de concorrência para obter mais informações sobre isolamento de transação e controle de concorrência.

Esta opção não é benéfica para uma exportação que se destina apenas à recuperação de desastres. Pode ser útil para uma exportação usada para importar uma cópia do banco de dados para fins de geração de relatórios, ou outro compartilhamento de carga leitura-apenas, enquanto o banco de dados original continua sendo atualizado. Sem esta opção, a exportação pode refletir um estado que não é consistente com qualquer execução serial das transações eventualmente efetivadas. Por exemplo, se forem usadas técnicas de processamento em lote, um lote pode aparecer como fechado na exportação, sem que todos os itens presentes no lote estejam na exportação.

Esta opção não fará diferença se não houver transações de leitura/escrita ativas quando o pg_dump foi iniciado. Se transações de leitura e escrita estiverem ativas, o início da exportação poderá ser atrasado por um período de tempo indeterminado. Uma vez em execução, o desempenho com ou sem esta opção é o mesmo.

Usa o instantâneo sincronizado indicado ao fazer a cópia de segurança do banco de dados (veja Tabela 9.100 para obter mais detalhes).

Esta opção é útil quando é necessário sincronizar a cópia de segurança com um encaixe de replicação lógica (veja Logical Decoding) ou com uma sessão concorrente.

No caso de uma cópia de segurança paralela, é usado o nome do instantâneo indicado por esta opção, em vez de obter um novo instantâneo.

Exporta estatísticas do otimizador.

Exporta apenas as estatísticas, não o esquema (definições de dados) ou os dados em si. São exportadas as estatísticas do otimizador para tabelas, visões materializadas, tabelas estrangeiras e índices.

Requer que cada padrão de extensão (-e/--extension), esquema (-n/--schema) e tabela (-t/--table) corresponda a pelo menos uma extensão/esquema/tabela no banco de dados a ser exportado. Note que, se nenhum dos padrões de extensão/esquema/tabela encontrar alguma correspondência, o pg_dump irá gerar um erro mesmo sem a opção --strict-names.

Esta opção não tem efeito sobre --exclude-extension, -N/--exclude-schema, -T/--exclude-table ou --exclude-table-data. Um padrão de exclusão que não corresponda a nenhum objeto não é considerado um erro.

Quando definido como fsync, que é o padrão, o pg_dump --format=diretório irá abrir e sincronizar recursivamente todos os arquivos no diretório de exportação.

No Linux, pode ser usado o syncfs para solicitar ao sistema operacional que sincronize todo o sistema de arquivos que contém o diretório de exportação. Veja recovery_init_sync_method para obter informações sobre as precauções a serem tomadas ao usar o syncfs.

Esta opção não tem efeito quando é usada a opção --no-sync, ou quando --format não é definido como directory.

Esta opção é semelhante à opção -t/--table, exceto por também incluir quaisquer partições ou tabelas filhas de herança da(s) tabela(s) que correspondem ao padrão.

Gera comandos SET SESSION AUTHORIZATION no padrão SQL, em vez de comandos ALTER OWNER para especificar o dono de um objeto. Isto torna a exportação mais compatível com os padrões, mas, dependendo do histórico dos objetos na exportação, pode não ser importado corretamente. Além disso, uma exportação usando SET SESSION AUTHORIZATION certamente irá precisar de privilégios de superusuário para importar corretamente, enquanto o comando ALTER OWNER requer privilégios menores.

Mostra a ajuda sobre os argumentos de linha de comando do pg_dump, e termina.

Especifica o nome do banco de dados ao qual se conectar. Esta opção equivale a especificar o nome_do_banco_de_dados como o primeiro argumento não-opção na linha de comando. O nome_do_banco_de_dados pode ser uma cadeia de caracteres de conexão. Neste caso, os parâmetros da cadeia de caracteres de conexão prevalecem sobre quaisquer opções de linha de comando conflitantes.

Especifica o nome de hospedeiro da máquina na qual o servidor está sendo executado. Se começar com uma barra, será usado como o diretório para o soquete de domínio Unix. O padrão é obtido da variável de ambiente PGHOST, se definida, caso contrário, uma conexão de soquete de domínio Unix é tentada.

Especifica a porta TCP, ou a extensão do arquivo de soquete de domínio Unix local, na qual o servidor está aguardando conexões. O padrão é a variável de ambiente PGPORT, se definida, ou o padrão compilado.

Nome de usuário para se conectar como.

Nunca emita uma solicitação de senha. Se o servidor exigir autenticação por senha, e uma senha não estiver disponível por outros meios, como o arquivo .pgpass, a tentativa de conexão irá falhar. Esta opção pode ser útil em tarefas em lote e scripts nos quais nenhum usuário está presente para inserir uma senha.

Força o pg_dump solicitar a senha antes de conectar ao banco de dados.

Esta opção nunca é essencial, porque o pg_dump solicita automaticamente a senha se o servidor exigir autenticação por senha. No entanto, o pg_dump irá desperdiçar uma tentativa de conexão ao descobrir que o servidor pede uma senha. Em alguns casos vale a pena digitar -W para evitar a tentativa extra de conexão.

Especifica o nome da função de banco de dados (role) a ser usada para criar a cópia de segurança. Esta opção faz com que o pg_dump emita o comando SET ROLE nome_da_role após a conexão com o banco de dados. É útil quando o usuário autenticado (especificado pela opção -U) não possui os privilégios necessários para o pg_dump, mas pode mudar para uma função de banco de dados com os privilégios necessários. Algumas instalações têm uma política contra se conectar diretamente como um superusuário, e o uso dessa opção permite que sejam feitas cópias de segurança que não violam esta política.

Parâmetros de conexão padrão.

Especifica se devem ser usadas cores nas mensagens de diagnóstico. Os valores possíveis são always, auto e never.