Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Consultar dados federados
/
Definir Armazenamento de Dados
/
Balde AWS S3

Usar tipos de atributo de partição

Nesta página

  • Tipos de atributos de partição suportados
  • Conversões suportadas

Observação

Ao especificar o path:

  • Especifique o tipo de dados para o atributo de partição.

  • Certifique-se de que o tipo de atributo de partição corresponda ao tipo de dados para analisar.

  • Utilize o delimitador especificado em delimiter.

Ao especificar atributos do mesmo tipo, faça qualquer um dos seguintes:

Tipos de atributos de partição suportados

A tabela a seguir lista os tipos de dados suportados para atributos de partição, nome de arquivo e exemplo do path para cada tipo de dados:

Chave
Tipo de Dados
Exemplo
string
Analisa o nome do arquivo como uma string.

nome do arquivo: /employees/949-555-0195.json

caminho: /employees/{phone string}

No exemplo anterior, o Data Federation interpreta phone como uma string.

Para saber mais, consulte Analisando valores nulos de nomes de arquivos.

int
Analisa o nome do arquivo como um número inteiro.

nome do arquivo: /zipcodes/90210.json

caminho: /zipcodes/{zipcode int}

No exemplo anterior, o Data Federation interpreta zipcode como um número inteiro.

Para saber mais, consulte Analisando números acolchoados de nomes de arquivos.

isodate
Analisa o nome do arquivo em RFC 3339 formato como uma8601 data no formato ISO- .

nome do arquivo: /metrics/20060102.json

  • caminho: /metrics/{startTimestamp isodate}

  • caminho: /metrics/{startTimestamp isodate('20060102')}

No exemplo anterior, para o primeiro caminho, o Data Federation interpreta startTimestamp como um ISODate. Para o segundo caminho, o Data Federation interpreta startTimestamp como um ISODate no formato especificado e corresponde apenas a nomes de arquivo no formato especificado.

Se você não especificar um formato específico como mostrado no primeiro exemplo de caminho de atributo ISODate acima, o Atlas Data Federation padronizará para partições com os seguintes formatos de data:

1"2006-01-02T15:04:05Z07:00"
2"2006-01-02T15:04:05.000000Z07:00"
3"2006-01-02"
4"2006-01-02T15:04:05.000000-0700"
5"2006-01-02T15:04:05-0700"
6"2006-01-02T15:04Z07:00"
7"2006-01-02T15:04-0700"
8"2006-01-02Z07:00"
9"2006-01-02-0700"
10"2006102T15:04:05.000000Z07:00"
11"20060102T15:04:05.000000-0700"
12"20060102T15:04:05Z07:00"
13"20060102T15:04:05-0700"
14"20060102T15:04Z07:00"
15"20060102T15:04-0700"
16"20060102Z07:00"
17"20060102-0700"
18"20060102"

Se você deseja especificar um formato, o que melhora o desempenho, deverá usar valores especiais para indicar a posição exata dos atributos na data, como dia (02), mês (01), ano ( )2006, etc. Para saber mais sobre o formato e os valores usados para especificar a data, consulte Formatar uma hora ou data. Se você especificar um formato que não está em um RFC 3339 formato, você deve usar regex com os valores especiais para indicar a posição dos atributos de data. Para ver um exemplo, consulte Criar partições a partir de ISODate.

epoch_secs
Analisa o nome do arquivo como um carimbo de data/hora Unix em segundos.

nome do arquivo: /metrics/1549046112.json

caminho: /metrics/{startTimestamp epoch_secs}

No exemplo anterior, o Data Federation interpreta startTimestamp como um carimbo de data/hora Unix em segundos.

Para saber mais, consulte Analisando números acolchoados de nomes de arquivos.

epoch_millis
Analisa o nome do arquivo como um carimbo de data/hora Unix em milissegundos.

nome do arquivo: /metrics/1549046112000.json

caminho: /metrics/{startTimestamp epoch_millis}

No exemplo anterior, o Data Federation interpreta startTimestamp como um carimbo de data/hora Unix em milissegundos.

Para saber mais, consulte Analisando números acolchoados de nomes de arquivos.

objectid
Analisa o nome do arquivo como um ObjectId.

nome do arquivo: /metrics/507f1f77bcf86cd799439011.json

caminho: /metrics/{objid objectid}

No exemplo anterior, o Data Federation interpreta objid como um ObjectId.

uuid
Analisa o nome do arquivo como um UUID do subtipo binário 4.

nome do arquivo: /metrics/3b241101-e2bb-4255-8caf-4136c566a962.json

caminho: /metrics/{myUuid uuid}

No exemplo anterior, Data Federation interpreta myUuid como um UUID do subtipo binário 4.

Observação

O Atlas Data Federation oferece suporte à sintaxe do pacote para expressões regulares no caminho para o nome do arquivo.

Conversões suportadas

O Atlas Data Federation converte os atributos da partição em tipos de BSON ao analisar o para o nome do arquivo. As gravações posteriores de dados path em S3 devem usar os tipos BSON após convertê-las em string. A tabela a seguir mostra:

  • Os tipos de atributo de partição e os tipos de BSON para os quais a Data Federation os converte.

  • O tipo de dados BSON para converter em uma string para gravações posteriores no S3.

Tipo de atributo de partição
Tipo de BSON analisado
Tipo de BSON da fonte
string

  • String UTF-8

  • zero*

  • String UTF-8

  • zero

int

  • Inteiro de 64 bits

  • zero

  • Inteiro de bits

  • Inteiro de 64 bits

  • nulo (como strings sem preenchimento)

isodate

  • Data hora UTC

  • zero

  • Data e hora UTC (como um ISO-8601 string de formato)

  • zero

objectid

  • ObjectId (como uma string com codificação hexadecimal)

  • zero

uuid

Voltar

Definir caminho para dados S3