Configurar opções de formatação de arquivo para destinos baseados em arquivo
A opção para configurar várias opções de formatação de arquivo para os arquivos exportados está disponível ao conectar a um destino baseado em arquivo, como o Amazon S3, o Azure Blob ou o SFTP.
Você pode configurar várias opções de formatação de arquivo para arquivos exportados usando a interface do usuário do Experience Platform. Você pode modificar várias propriedades dos arquivos exportados para corresponder aos requisitos do sistema de recebimento de arquivos do seu lado, a fim de ler e interpretar de maneira ideal os arquivos recebidos do Experience Platform.
Configuração da formatação de arquivo para arquivos CSV file-configuration
Para exibir as opções de formatação de arquivo, inicie o fluxo de trabalho conectar ao destino. Selecione Tipo de dados: Segmentos e Tipo de arquivo: CSV para exibir as configurações de formatação de arquivo disponíveis para os arquivos CSV exportados.
Delimitador delimiter
Use esse controle para definir um separador para cada campo e valor nos arquivos CSV exportados. As opções disponíveis são:
- Dois pontos
(:) - Vírgula
(,) - Pipe
(|) - Ponto e vírgula
(;) - Guia
(\t)
Exemplos
Veja os exemplos abaixo do conteúdo nos arquivos CSV exportados com cada uma das seleções na interface do usuário.
- Exemplo de saída com Dois-pontos
(:)selecionados:male:John:Doe - Exemplo de saída com Vírgula
(,)selecionada:male,John,Doe - Exemplo de saída com Pipe
(|)selecionado:male|John|Doe - Exemplo de saída com Ponto e vírgula
(;)selecionado:male;John;Doe - Exemplo de saída com Tab
(\t)selecionada:male \t John \t Doe
Caractere de aspas quote-character
Use essa opção para controlar se as aspas duplas devem ser removidas ou mantidas nas cadeias de caracteres exportadas.
As opções disponíveis são:
- Caractere Nulo (\0000). Use essa opção para remover aspas duplas de arquivos CSV exportados.
- Aspas Duplas ("). Use essa opção quando os valores da string contiverem um delimitador ou aspas duplas. Essa opção ajuda a manter os delimitadores ou aspas duplas nos arquivos CSV exportados, para que você possa identificar corretamente qual valor corresponde a qual campo.
Exemplos
Considere o valor de entrada Anna,"Doe,John".
Veja os exemplos abaixo do conteúdo de arquivos CSV exportados com cada uma das seleções na interface.
- Exemplo de saída com Caractere nulo (\0000) selecionado:
Anna,Doe,John - Exemplo de saída com Aspas Duplas (") selecionadas:
Anna,"Doe,John"
Caractere de escape escape-character
Use esta opção para definir um caractere único para aspas de escape dentro de um valor já citado. Por exemplo, essa opção é útil quando você tem uma string entre aspas duplas em que parte da string já está entre aspas duplas. Esta opção determina com qual caractere substituir as aspas duplas internas. As opções disponíveis são:
- Barra invertida
(\) - Aspas simples
(')
Exemplos
Veja os exemplos abaixo do conteúdo de arquivos CSV exportados com cada uma das seleções na interface.
- Exemplo de saída com Barra invertida
(\)selecionada:"Test,\"John\",LastName" - Exemplo de saída com Aspas simples
(')selecionadas:"Test,'"John'",LastName"
Saída de valor vazio empty-value-output
Use este controle para definir a representação da sequência de caracteres de um valor vazio. Essa opção determina como os valores vazios são representados nos arquivos CSV exportados. As opções disponíveis são:
- Nulo (nulo)
- Cadeia de Caracteres Vazia entre Aspas Duplas ("")
- Cadeia de caracteres vazia
Exemplos
Veja os exemplos abaixo do conteúdo de arquivos CSV exportados com cada uma das seleções na interface.
- Exemplo de saída com null selecionado:
male,NULL,TestLastName. Nesse caso, o Experience Platform transforma o valor vazio em um valor nulo. - Exemplo de saída com " selecionado:
male,"",TestLastName. Nesse caso, Experience Platform transforma o valor vazio em um par de aspas duplas. - Exemplo de saída com Cadeia de caracteres vazia selecionada:
male,,TestLastName. Nesse caso, o Experience Platform mantém o valor vazio e o exporta como está (sem aspas duplas).
Saída de valor nulo null-value-output
Use esse controle para definir como as strings de valor nulo devem ser representadas nos arquivos exportados. Essa opção determina como os valores nulos são representados nos arquivos CSV exportados. As opções disponíveis são:
- Nulo (nulo)
- Cadeia de Caracteres Vazia entre Aspas Duplas ("")
- Cadeia de caracteres vazia
Exemplos
Veja os exemplos abaixo do conteúdo de arquivos CSV exportados com cada uma das seleções na interface.
- Exemplo de saída com null selecionado:
male,NULL,TestLastName. Nesse caso, não ocorre nenhuma transformação e o arquivo CSV contém o valor nulo. - Exemplo de saída com " selecionado:
male,"",TestLastName. Nesse caso, o Experience Platform substitui o valor nulo por aspas duplas em torno de uma string vazia. - Exemplo de saída com Cadeia de caracteres vazia selecionada:
male,,TestLastName. Nesse caso, o Experience Platform substitui o valor nulo por uma string vazia (sem aspas duplas).
Formato de compactação compression-format
Define o tipo de compactação a ser usado ao salvar dados no arquivo. As opções compatíveis são GZIP e NONE. Essa opção determina se você exportará ou não arquivos compactados.
Codificação
Não mostrado na captura de tela da interface do usuário. Especifica a codificação (conjunto de caracteres) dos arquivos CSV salvos. As opções são UTF-8 ou UTF-16.
Caractere para aspas de escape
Não mostrado na captura de tela da interface do usuário. Um sinalizador que indica se os valores que contêm aspas devem sempre estar entre aspas.
O padrão é omitir todos os valores que contenham um caractere de aspas.
Separador de linha
Não mostrado na captura de tela da interface do usuário. Define o separador de linha que deve ser usado para gravação. O comprimento máximo é de 1 caractere.
Ignorar espaço em branco à esquerda
Não mostrado na captura de tela da interface do usuário. Um sinalizador que indica se os espaços em branco à esquerda dos valores que estão sendo exportados deve ser ignorado.
Exemplo de saída com True selecionado: "male","John","TestLastName"
Exemplo de saída com Falso selecionado: " male","John","TestLastName"
Ignorar espaço em branco à direita
Não mostrado na captura de tela da interface do usuário. Um sinalizador que indica se espaços em branco à direita de valores que estão sendo exportados deve ser ignorado.
Exemplo de saída com True selecionado: "male","John","TestLastName"
Exemplo de saída com Falso selecionado: "male ","John","TestLastName"
Próximas etapas next-steps
Depois de ler este documento, agora você sabe como configurar as opções de exportação de arquivo para seus arquivos de dados CSV para adaptar o conteúdo do arquivo aos requisitos do sistema de recebimento de arquivos downstream. Em seguida, você pode ler o tutorial de ativação de destinos baseados em arquivo para começar a exportar arquivos para seu local de armazenamento na nuvem preferido.