Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo descreve como usar a atividade de cópia em pipelines para copiar dados de e para PostgreSQL.
Configuração com suporte
Para a configuração de cada guia em atividade Copy, vá para as seções a seguir, respectivamente.
Geral
Veja as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.
Fonte
Vá para a guia Origem para configurar a fonte da sua atividade de cópia. Consulte o conteúdo a seguir para obter a configuração detalhada.
As seguintes propriedades são obrigatórias:
- Conexão: selecione uma conexão PostgreSQL na lista de conexões. Se nenhuma conexão existir, crie uma nova conexão PostgreSQL.
- Tipo de conexão: selecione postgreSQL.
-
Usar consulta: selecione Tabela ou Consulta.
Se você selecionar Tabela:
Tabela: especifique o nome da tabela para ler dados. Selecione a tabela na lista suspensa ou selecione Inserir manualmente para inseri-la.
Se você selecionar Consulta:
Consulta: Especifique a consulta SQL personalizada para ler os dados.
Nota
Os nomes de esquema e tabela diferenciam maiúsculas de minúsculas. Coloque-os em "" (aspas duplas) na consulta.
Em Avançado, você pode especificar os seguintes campos:
- tempo limite de consulta (minutos): especifique o tempo de espera antes de encerrar a tentativa de executar um comando e gerar um erro, o padrão é 120 minutos. Se o parâmetro for definido para essa propriedade, os valores permitidos serão intervalos de tempo, como "02:00:00" (120 minutos). Para obter mais informações, consulte CommandTimeout.
- Colunas adicionais: adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão tem suporte para o último.
Destino
As propriedades a seguir são suportadas para PostgreSQL na guia Destino de uma atividade de cópia.
As seguintes propriedades são necessárias:
- Conexão: selecione uma conexão PostgreSQL na lista de conexões.
- Tipo de conexão: selecione postgreSQL.
- Tabela: Especifique o nome da tabela para gravar dados. Selecione a tabela na lista suspensa ou selecione Inserir manualmente para inserir o esquema e o nome da tabela.
Em Avançado, você pode especificar os seguintes campos:
- Script de pré-cópia: especifique uma consulta SQL para a atividade de cópia a ser executada antes de gravar dados no PostgreSQL em cada execução. Você pode usar essa propriedade para limpar os dados pré-carregados.
-
Tempo limite de gravação em lote: especifique o tempo de espera para que a operação de inserção em lote seja concluída antes de atingir o tempo limite. O valor permitido é um intervalo de tempo. O valor padrão é
00:02:00. -
Tamanho do lote: especifique o número de linhas a serem inseridas de uma vez na tabela PostgreSQL. O valor permitido é inteiro (número de linhas). Um novo lote será criado quando o lote atual atingir o tamanho do lote de gravação. O valor padrão é
50000. - Máximo de conexões simultâneas: especifique o limite superior de conexões simultâneas estabelecidas com o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas. O valor permitido é inteiro.
Mapeamento
Para a configuração da guia Mapeamento, acesse Configurar seus mapeamentos na guia mapeamento.
Configurações
Para configuração da guia Configurações, acesse Definir suas outras configurações na guia configurações.
Mapeamento de tipo de dados para PostgreSQL
Ao copiar dados do PostgreSQL, os mapeamentos a seguir são usados de tipos de dados do PostgreSQL para tipos de dados provisórios usados internamente com o serviço.
| Tipo de dados do PostgreSQL | Tipo de dados provisório do serviço |
|---|---|
| smallint | Int16 |
| inteiro | Int32 |
| bigint | Int64 |
| decimal (precisão <= 28) | Decimal |
| decimal (precisão > 28) | Sem suporte |
| numeric | Decimal |
| real | Solteiro |
| double | Double |
| smallserial | Int16 |
| serial | Int32 |
| bigserial | Int64 |
| dinheiro | Decimal |
| char(n) | String |
| varchar(n) | String |
| enviar SMS | String |
| bytea | Byte[] |
| carimbo de data/hora | DateTime |
| carimbo de data/hora com fuso horário | DateTime |
| data | DateTime |
| hora | TimeSpan |
| hora com fuso horário | DateTimeOffset |
| intervalo | TimeSpan |
| boolean | booleano |
| ponto | String |
| linha | String |
| lseg | String |
| caixa | String |
| caminho | String |
| polígono | String |
| círculo | String |
| CIDR | String |
| Inet | String |
| macaddr | String |
| macaddr8 | String |
| tsvector | String |
| tsquery | String |
| uuid | Guid |
| Json | String |
| jsonb | String |
| matriz | String |
| bit | Byte[] |
| bit variável | Byte[] |
| xml | String |
| inteiro[] | String |
| text[] | String |
| numérico[] | String |
| date[] | String |
| alcance | String |
| bpchar | String |
Ao copiar dados para o PostgreSQL, os mapeamentos a seguir são usados de tipos de dados provisórios usados pelo serviço internamente para tipos de dados PostgreSQL.
| Tipo de dados provisório | Tipo de dados do PostgreSQL |
|---|---|
| Int16 | smallint |
| Int32 | inteiro |
| Int64 | bigint |
| Solteiro | real |
| Double | precisão dupla |
| Decimal | numérico, dinheiro |
| booleano | boolean |
| String | text, char(n), varchar(n), name, citext, json,jsonb, xml, inet, cidr, macaddr, tsvector, tsquery, point, line, lseg, box, path, polygon, circle, int4range, int8range, numrange, daterange, tsrange, tstzrange, integer[] |
| Matriz de bytes | bytea, bit(n), varbit |
| Date | data |
| TimeSpan | tempo, intervalo |
| DateTimeOffset | Timetz, Timestamptz |
| DateTime | carimbo de data/hora |
| GUID | uuid |
Resumo da tabela
A tabela a seguir contém mais informações sobre a atividade de cópia no PostgreSQL.
Informações de origem
| Nome | Descrição | Valor | Necessário | Propriedade de script JSON |
|---|---|---|---|---|
| Conexão | Sua conexão com o armazenamento de dados de origem. | < sua Conexão PostgreSQL > | Sim | conexão |
| Tipo de conexão | Seu tipo de conexão de origem. | PostgreSQL | Sim | / |
| Usar consulta | A maneira de ler dados. Aplique Tabela para ler dados da tabela especificada ou aplique Consulta para ler dados usando consultas SQL. | • Tabela • Consulta |
Sim | • typeProperties (em typeProperties ->source)-esquema - mesa • consulta |
| tempo limite de consulta (minutos) | O tempo de espera antes de encerrar a tentativa de executar um comando e gerar um erro, o padrão é de 120 minutos. Se o parâmetro for definido para essa propriedade, os valores permitidos serão intervalos de tempo, como "02:00:00" (120 minutos). Para obter mais informações, consulte CommandTimeout. | TimeSpan | Não | queryTimeout |
| Colunas adicionais | Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão tem suporte para o último. | •Nome • Valor |
Não | colunas adicionais: •nome •valor |
Informações de destino
| Nome | Descrição | Valor | Necessário | Propriedade de script JSON |
|---|---|---|---|---|
| Conexão | Sua ligação com o banco de dados de destino. | < sua Conexão PostgreSQL > | Sim | conexão |
| Tabela | O nome da tabela para gravar dados. Selecione a tabela na lista suspensa ou selecione Inserir manualmente para inserir o esquema e o nome da tabela. | < nome da tabela > | Sim | typeProperties: • esquema • tabela |
| Script pré-cópia | Uma consulta SQL para a atividade de cópia a ser executada antes de gravar dados no PostgreSQL em cada execução. Você pode usar essa propriedade para limpar os dados pré-carregados. | < seu script de pré-cópia > | Não | preCopyScript |
| Comportamento de gravação | Define o comportamento de gravação. | insert (padrão) | Não | writeBehavior |
| Tamanho do lote de gravação | O número de linhas a serem inseridas na tabela PostgreSQL por lote. O valor permitido é inteiro (número de linhas). |
< Inteiro >50000 (padrão) |
Não | writeBatchSize |
| Tempo limite do lote de gravação | O tempo de espera para que a operação de inserção em lote seja concluída antes de atingir o tempo limite. O valor permitido é um intervalo de tempo. |
< Intervalo de tempo >00:02:00 (padrão) |
Não | writeBatchTimeout |
| Máximo de conexões simultâneas | O limite máximo de conexões simultâneas estabelecidas com o banco de dados durante a execução da atividade. O valor permitido é inteiro. | < Inteiro > | Não | maxConcurrentConnections |