Explicação dos pares de valor-chave key-value-pairs-explained

Define e descreve pares de valores chave padrão e serializados.

Um par de valor-chave consiste em dois elementos de dados relacionados: uma chave, que é uma constante que define o conjunto de dados (por exemplo, gênero, cor, preço), e um valor, que é uma variável que pertence ao conjunto (por exemplo, masculino/feminino, verde, 100). Totalmente formado, um par de valores-chave pode ser semelhante a:

  • gender = male
  • color = green
  • price > 100

Pares de valor-chave padrão e serializados standard-serialized-pairs

Os destinos aceitam dados de valores-chave no formato standard ou serialized. A formatação padrão organiza os dados em pares de valores chave separados. Cada chave é declarada explicitamente, mesmo quando usada novamente para definir um valor diferente. Por outro lado, a formatação serializada condensa vários valores em um conjunto definido por uma única chave. Além disso, em um par serializado, um indicador especial é usado para separar os valores no conjunto de valores chave. Finalmente, valores-chave padrão e serializados podem conter um ou vários valores. A tabela a seguir fornece exemplos de formatos de valor-chave padrão e serial.

Formatação
Tecla única
Pares de valor-chave
Padrão
x=1&x=2
x=1&x=2&y=3&y=4
Serializado
x=1;2
x=1;2&y=3;4

Chaves, delimitadores e separadores keys-delimiters-separators

Ao trabalhar com dados serializados, você deve especificar os caracteres que separam os valores dentro e entre os pares de valores chave. Os elementos em pares de valor-chave são definidos da seguinte maneira:

  • Chave: um identificador exclusivo no par chave-valor.
  • Delimitador de valor: separa pares de valor-chave individuais.
  • Separador de valor-chave: separa uma chave dos valores em um par de valor-chave.
  • Separador serial: separa valores individuais em pares de valores chave serializados.

Elementos de valor-chave padrão e serializados standard-serialized-key-value-elements

Tipo
Exemplo
Chave
Separador de valor-chave
Delimitador de valor-chave
Separador serial
Chave única (padrão)
x=1&x=2
x
=
&
n/a
Pares de valor-chave (padrão)
x=1&x=2&y=3&y=4
x,y
=
&
n/a
Chave única (serial)
x=1;2;3
x
=
n/a
;
Pares de valor-chave (serial)
x=1;2&y=3;4
x,y
=
&
;
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695