A classe SortOptions
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A classe SortExpression representa uma classificação multidimensional de documentos.
O seguinte código mostra como classificar documentos com base na classificação do produto em ordem decrescente e, em seguida, o produto mais barato em produtos com classificação semelhante, classificando 1.000 documentos, no máximo:
SortOptions(expressions=[
SortExpression(expression='rating',
direction=SortExpression.DESCENDING, default_value=0),
SortExpression(expression='price + tax',
direction=SortExpression.ASCENDING, default_value=999999.99)],
limit=1000)
SortOptions é definido no módulo google.appengine.api.search.
Construtor
O construtor da classe SortOptions é definido da seguinte maneira:
-
class SortOptions(expressions=None, match_scorer=None, limit=1000)
Classifica documentos de acordo com as opções especificadas.
Argumentos
- expressions
Um iterável de SortExpression que representa uma classificação multidimensional de documentos.
- match_scorer
Uma especificação de marcador de correspondência que pode ser usada para marcar documentos ou em um SortExpression combinado com outros recursos.
- limit
O limite quanto ao número de documentos para pontuação. É recomendável definir esse limite em grandes índices.
Valor do resultado
Uma nova instância da classe SortOptions.
Exceções
- TypeError
Se algum dos parâmetros tiver um tipo inválido ou um atributo desconhecido for passado.
- ValueError
Se algum parâmetro tiver um valor inválido.
Propriedades
Uma instância da classe SortOptions tem as seguintes propriedades:
- expressions
Retorna uma lista de SortExpression especificando uma classificação multidimensional.
- match_scorer
Retorna um marcador de correspondência usado para marcar documentos.
- limit
Retorna o limite quanto ao número de documentos para pontuação.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-30 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-30 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eSortOptions\u003c/code\u003e class enables multi-dimensional sorting of documents, leveraging \u003ccode\u003eSortExpression\u003c/code\u003e for detailed control.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSortOptions\u003c/code\u003e allows specifying sorting criteria using an iterable of \u003ccode\u003eSortExpression\u003c/code\u003e, a match scorer, and a limit on the number of documents to sort.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eSortOptions\u003c/code\u003e constructor can be configured with \u003ccode\u003eexpressions\u003c/code\u003e, \u003ccode\u003ematch_scorer\u003c/code\u003e, and \u003ccode\u003elimit\u003c/code\u003e, throwing \u003ccode\u003eTypeError\u003c/code\u003e or \u003ccode\u003eValueError\u003c/code\u003e if input is invalid.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSortExpression\u003c/code\u003e objects can define the direction of sorting, such as ascending or descending, and a default value for the sort key.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eSortOptions\u003c/code\u003e properties \u003ccode\u003eexpressions\u003c/code\u003e, \u003ccode\u003ematch_scorer\u003c/code\u003e, and \u003ccode\u003elimit\u003c/code\u003e allow you to access the configured settings for sorting.\u003c/p\u003e\n"]]],[],null,["# The SortOptions Class\n\nClass `SortExpression` represents a multi-dimensional sort of Documents.\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| python3\n|\n| /services/access). If you are updating to the App Engine Python 3 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/python-differences) to learn about your migration options for legacy bundled services.\n\nThe following code shows how to sort documents based on product rating\nin descending order and then cheapest product within similarly rated\nproducts, sorting at most 1000 documents: \n\n```python\n SortOptions(expressions=[\n SortExpression(expression='rating',\n direction=SortExpression.DESCENDING, default_value=0),\n SortExpression(expression='price + tax',\n direction=SortExpression.ASCENDING, default_value=999999.99)],\n limit=1000)\n```\n\n`SortOptions` is defined in the `google.appengine.api.search` module.\n\nConstructor\n-----------\n\nThe constructor for class `SortOptions` is defined as follows:\n\n\nclass SortOptions(expressions=None, match_scorer=None, limit=1000)\n\n:\n Sort documents according to the specified options.\n\n:\n\n Arguments\n\n expressions\n\n : An iterable of SortExpression representing a multi-dimensional sort of Documents.\n\n match_scorer\n\n : A match scorer specification which may be used to score documents or in a SortExpression combined with other features.\n\n limit\n\n : The limit on the number of documents to score. It is advisable to set this limit on large indexes.\n\n Result value\n\n : A new instance of class `SortOptions`.\n\n Exceptions\n\n TypeError\n\n : If any of the parameters have an invalid type, or an unknown attribute is passed.\n\n ValueError\n\n : If any parameter has an invalid value.\n\n \u003cbr /\u003e\n\nProperties\n----------\n\nAn instance of class `SortOptions` has the following properties:\n\nexpressions\n\n: Returns a list of SortExpression specifying a multi-dimensional sort.\n\nmatch_scorer\n\n: Returns a match scorer used to score documents.\n\nlimit\n\n: Returns the limit on the number of documents to score."]]
