Arquivos de controle de transferência para transferências de arquivos de log

Os arquivos de controle de transferência (.info) fornecem informações de metadados sobre transferências de arquivos para que os parceiros possam verificar se o Audience Manager processou transferências de arquivos corretamente.

Audience Manager envia um arquivo de controle de transferência para um parceiro com cada transferência de arquivo. Devido à natureza de vários segmentos do editor FTP, o arquivo de controle de transferência pode ser enviado antes que os arquivos reais acabem de ser transferidos.

Os metadados no arquivo .info permitem que os parceiros:

  • Determinar quando um ciclo de transferência completo está concluído (o número total de arquivos na sequência foi entregue);
  • Determinar se determinado arquivo na sequência está completo/correto (examinando o tamanho do arquivo em bytes e o número total de linhas);
  • Valide o número de linhas em arquivos brutos em relação ao número de linhas após os arquivos terem sido carregados no banco de dados na extremidade de recebimento (tamanho do arquivo em linhas).

Convenções de nomenclatura de arquivos

O arquivo de controle de transferência tem o mesmo nome da raiz do lote/sequência com uma extensão .info de arquivo.s

Por exemplo, se o primeiro arquivo da sequência tiver sido nomeado: ftp_12345_67890_full_1500727351632-1.sync, o arquivo de controle seria chamado de ftp_12345_67890_iter_1500727351632.info.

Formato do arquivo

{
  Files: [
    {
      FileByteSize: 293029329,
      FileLineCount: 36893908,
      FileName: "ftp_12345_67890_full_1500727351632-1.sync.gz",
      FileSequenceNumber: 1,
      md5: "983g634be2ad5263c6a6c4958bf61d9f"
    },
    {
      FileByteSize: 293039238,
      FileLineCount: 36895184,
      FileName: "ftp_12345_67890_full_1500727351632-2.sync.gz",
      FileSequenceNumber: 2,
      md5: "6sn9907c8e78cfd78409622e7b55a984"
    },
    {
      FileByteSize: 293050833,
      FileLineCount: 36896787,
      FileName: "ftp_12345_67890_full_1500727351632-3.sync.gz",
      FileSequenceNumber: 3,
      md5: "7cdfb8e74cd6cec1jy6vel21ccb4a962"
    },
    {
      FileByteSize: 218425764,
      FileLineCount: 27498226,
      FileName: "ftp_12345_67890_full_1500727351632-4.sync.gz",
      FileSequenceNumber: 4,
      md5: "7hs53149f8a2444457g968f04cbbdee5"
    }
  ],
  Totals: {
    FileName: "ftp_12345_67890_full_1500727351632.sync",
    TotalByteSize: 1097545164,
    TotalNumberFiles: 4,
    TotalNumberLines: 138184105
    }
}
OBSERVAÇÃO

Os números totais do lote são exclusivos do próprio arquivo .info. Ou seja, os totais não incluem o arquivo .info, seu tamanho de byte ou sua contagem de linhas.

Os tamanhos de bytes de arquivos e contagens de linhas incluem qualquer linha/linha de cabeçalho e espaçador (em branco). Para obter a contagem de linhas/linhas de dados reais, subtraia cabeçalhos.

O total de linhas no lote e o total de bytes são incluídos em qualquer linha de cabeçalho e espaço.

Nesta página