A recuperação escalar do OSS oferece suporte a campos e operadores específicos para consultas simples, operações de agregação e ordenação.
Observações
Consultas simples aceitam os seguintes operadores: eq (igual a), gt (maior que), gte (maior ou igual a), lt (menor que), lte (menor ou igual a), match (consulta difusa) e prefix (consulta por prefixo). Operações de agregação incluem: min (mínimo), max (máximo), average (média), sum (soma), count (contagem), distinct (contagem com deduplicação) e group (contagem agrupada).
-
Para pesquisar arquivos com o campo
OSSUserMeta.*, substitua o asterisco (*) pela chave dos metadados definidos pelo usuário. A correspondência ocorre pelo par chave-valor. A chave não diferencia maiúsculas de minúsculas, mas o valor diferencia.Por exemplo, para localizar arquivos com o metadado definido pelo usuário
x-oss-meta-location=hangzhou, defina a condição de consulta como{"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}. -
Para pesquisar arquivos com o campo
OSSTagging.*, substitua o asterisco (*) pela chave da tag do objeto. A correspondência ocorre pelo par chave-valor. Tanto a chave quanto o valor diferenciam maiúsculas de minúsculas.Por exemplo, para localizar arquivos com a tag
owner=John, defina a condição de consulta como{"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}.
Lista de suporte
A tabela a seguir lista os campos e os respectivos operadores compatíveis com consultas simples, operações de agregação e ordenação.
Nela, ✓ indica que o campo aceita o operador e × indica que não aceita.
|
Campo |
Descrição |
Operadores (em condições de consulta simples) |
Operadores (em operações de agregação) |
Ordenação |
|||
|
eq, gt, gte, lt, lte |
match |
prefix |
min, max, sum, average |
count, distinct, group |
|||
|
ETag |
Identifica o conteúdo do objeto. |
✓ |
× |
✓ |
× |
✓ |
✓ |
|
FileModifiedTime |
Hora da última modificação do objeto. |
✓ |
× |
× |
× |
✓ |
✓ |
|
Filename |
Nome do objeto, incluindo o caminho completo e o nome do arquivo. |
✓ |
✓ |
✓ |
× |
✓ |
✓ |
|
ObjectACL |
Lista de controle de acesso (ACL) do objeto. |
✓ |
× |
✓ |
× |
✓ |
✓ |
|
OSSCRC64 |
Valor CRC-64 de 64 bits do objeto. |
✓ |
× |
✓ |
× |
✓ |
✓ |
|
OSSObjectType |
Tipo do objeto. |
✓ |
× |
✓ |
× |
✓ |
✓ |
|
OSSStorageClass |
Classe de armazenamento do objeto. |
✓ |
× |
✓ |
× |
✓ |
✓ |
|
OSSTagging.* |
Tag do objeto. |
✓ |
× |
✓ |
× |
× |
× |
|
OSSTaggingCount |
Número de tags do objeto. |
✓ |
× |
× |
✓ |
✓ |
✓ |
|
Size |
Tamanho do objeto. |
✓ |
× |
× |
✓ |
✓ |
✓ |