Configurar opções de formatação de arquivo para destinos baseados em arquivo

IMPORTANT
As opções de formatação de arquivo descritas neste documento estão disponíveis somente para arquivos CSV.

A opção para configurar várias opções de formatação de arquivo para os arquivos exportados está disponível quando você conectar para um destino baseado em arquivo, como Amazon S3, Azure Blobou 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 conectar ao destino fluxo de trabalho. Selecionar Tipo de dados: Segmentos e Tipo de arquivo: CSV para exibir as configurações de formatação de arquivo disponíveis para o CSV arquivos.

IMPORTANT
O destino ao qual você está se conectando pode não ter todas essas opções disponíveis. Cabe ao desenvolvedor de destino determinar quais opções de formatação de arquivo ele deseja suportar em seu destino. O desenvolvedor de destino pode determinar quais opções estão disponíveis ao se conectar ao destino. As opções obrigatórias estão marcadas com um asterisco na interface do usuário do Experience Platform.
Os destinos de armazenamento na nuvem criados pelo Adobe - Amazon S3, Azure Blob, Armazenamento Azure Data Lake Gen2, Data Landing Zone, Armazenamento em nuvem Google, SFTP - atualmente, o suporta apenas as seis opções de CSV destacadas abaixo.

Imagem mostrando algumas das opções de formatação de arquivo disponíveis.

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 (,)
  • Estágio (|)
  • 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(:) selecionado: male:John:Doe
  • Exemplo de saída com Vírgula(,) selecionado: male,John,Doe
  • Exemplo de saída com Tubulação(|) selecionado: male|John|Doe
  • Exemplo de saída com Ponto e vírgula(;) selecionado: male;John;Doe
  • Exemplo de saída com Guia(\t) selecionado: male \t John \t Doe

Caractere de aspas quote-character

Use essa opção se desejar remover as aspas duplas das strings 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 para manter aspas duplas nos arquivos CSV exportados.

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 Caractere Nulo (\0000) selecionado: Test,John,LastName
  • Exemplo de saída com Aspas duplas (") selecionado: "Test","John","LastName"

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(\) selecionado: "Test,\"John\",LastName"
  • Exemplo de saída com Aspas simples(') selecionado: "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:

  • Null (null)
  • String vazia entre aspas duplas ("")
  • String 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 String vazia selecionado: male,,TestLastName. Nesse caso, o Experience Platform mantém o valor vazio e o exporta como está (sem aspas duplas).
TIP
A diferença entre a saída de valor vazio e a saída de valor nulo na seção abaixo é que um valor vazio tem um valor real que está vazio. O valor NULL não tem nenhum valor. Pense no valor vazio como um vidro vazio na tabela e no valor nulo como não tendo o vidro na tabela.

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:

  • Null (null)
  • String vazia entre aspas duplas ("")
  • String 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 String vazia selecionado: 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 o local de armazenamento na nuvem de sua preferência.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6