github.com/weaviate/weaviate@v1.24.6/adapters/handlers/graphql/descriptions/filters.go (about)

     1  //                           _       _
     2  // __      _____  __ ___   ___  __ _| |_ ___
     3  // \ \ /\ / / _ \/ _` \ \ / / |/ _` | __/ _ \
     4  //  \ V  V /  __/ (_| |\ V /| | (_| | ||  __/
     5  //   \_/\_/ \___|\__,_| \_/ |_|\__,_|\__\___|
     6  //
     7  //  Copyright © 2016 - 2024 Weaviate B.V. All rights reserved.
     8  //
     9  //  CONTACT: hello@weaviate.io
    10  //
    11  
    12  // Package descriptions provides the descriptions as used by the graphql endpoint for Weaviate
    13  package descriptions
    14  
    15  // Where filter elements
    16  const (
    17  	GetWhere       = "Filter options for a local Get query, used to convert the result to the specified filters"
    18  	GetWhereInpObj = "An object containing filter options for a local Get query, used to convert the result to the specified filters"
    19  )
    20  
    21  const (
    22  	LocalMetaWhere       = "Filter options for a local Meta query, used to convert the result to the specified filters"
    23  	LocalMetaWhereInpObj = "An object containing filter options for a local Meta query, used to convert the result to the specified filters"
    24  )
    25  
    26  const (
    27  	AggregateWhere       = "Filter options for a local Aggregate query, used to convert the result to the specified filters"
    28  	AggregateWhereInpObj = "An object containing filter options for a local Aggregate query, used to convert the result to the specified filters"
    29  )
    30  
    31  const (
    32  	NetworkGetWhere       = "Filter options for a network Get query, used to convert the result to the specified filters"
    33  	NetworkGetWhereInpObj = "An object containing filter options for a network Get query, used to convert the result to the specified filters"
    34  )
    35  
    36  const (
    37  	NetworkMetaWhere       = "Filter options for a network Meta query, used to convert the result to the specified filters"
    38  	NetworkMetaWhereInpObj = "An object containing filter options for a network Meta query, used to convert the result to the specified filters"
    39  )
    40  
    41  const (
    42  	NetworkAggregateWhere       = "Filter options for a network Aggregate query, used to convert the result to the specified filters"
    43  	NetworkAggregateWhereInpObj = "An object containing filter options for a network Aggregate query, used to convert the result to the specified filters"
    44  )
    45  
    46  const (
    47  	WhereOperands       = "Contains the Operands that can be applied to a 'where' filter"
    48  	WhereOperandsInpObj = "An object containing the Operands that can be applied to a 'where' filter"
    49  )
    50  
    51  const (
    52  	WhereOperator     = "Contains the Operators that can be applied to a 'where' filter"
    53  	WhereOperatorEnum = "An object containing the Operators that can be applied to a 'where' filter"
    54  )
    55  
    56  const WherePath = "Specify the path from the Objects fields to the property name (e.g. ['Things', 'City', 'population'] leads to the 'population' property of a 'City' object)"
    57  
    58  const (
    59  	WhereValueInt                          = "Specify an Integer value that the target property will be compared to"
    60  	WhereValueNumber                       = "Specify a Float value that the target property will be compared to"
    61  	WhereValueBoolean                      = "Specify a Boolean value that the target property will be compared to"
    62  	WhereValueString                       = "Specify a String value that the target property will be compared to"
    63  	WhereValueRange                        = "Specify both geo-coordinates (latitude and longitude as decimals) and a maximum distance from the described coordinates. The search will return any result which is located less than or equal to the specified maximum distance in km away from the specified point."
    64  	WhereValueRangeGeoCoordinates          = "The geoCoordinates that form the center point of the search."
    65  	WhereValueRangeGeoCoordinatesLatitude  = "The latitude (in decimal format) of the geoCoordinates to search around."
    66  	WhereValueRangeGeoCoordinatesLongitude = "The longitude (in decimal format) of the geoCoordinates to search around."
    67  	WhereValueRangeDistance                = "The distance from the point specified via geoCoordinates."
    68  	WhereValueRangeDistanceMax             = "The maximum distance from the point specified geoCoordinates."
    69  	WhereValueText                         = "Specify a Text value that the target property will be compared to"
    70  	WhereValueDate                         = "Specify a Date value that the target property will be compared to"
    71  )
    72  
    73  // Properties and Classes filter elements (used by Fetch and Introspect Where filters)
    74  const (
    75  	WhereProperties    = "Specify which properties to filter on"
    76  	WherePropertiesObj = "Specify which properties to filter on"
    77  )
    78  
    79  const (
    80  	WherePropertiesPropertyName = "Specify which property name to filter properties on"
    81  	WhereCertainty              = "Specify the required degree of similarity between an object's characteristics and the provided filter values on a scale of 0-1"
    82  	WhereName                   = "Specify the name of the property to filter on"
    83  )
    84  
    85  const (
    86  	WhereKeywords       = "Specify which keywords to filter on"
    87  	WhereKeywordsInpObj = "Specify the value and the weight of a keyword"
    88  )
    89  
    90  const (
    91  	WhereKeywordsValue  = "Specify the value of the keyword"
    92  	WhereKeywordsWeight = "Specify the weight of the keyword"
    93  )
    94  
    95  const (
    96  	WhereClass  = "Specify which classes to filter on"
    97  	WhereInpObj = "Specify which classes and properties to filter on"
    98  )
    99  
   100  // Unique Fetch filter elements
   101  const (
   102  	FetchWhereFilterFields       = "An object containing filter options for a network Fetch search, used to convert the result to the specified filters"
   103  	FetchWhereFilterFieldsInpObj = "Filter options for a network Fetch search, used to convert the result to the specified filters"
   104  )
   105  
   106  const (
   107  	FetchFuzzyValue     = "Specify the concept that will be used to fetch Objects on the network (e.g. 'Airplane', or 'City')"
   108  	FetchFuzzyCertainty = "Specify how much a Beacon's characteristics must match the provided concept on a scale of 0 to 1"
   109  )
   110  
   111  // Unique Introspect filter elements
   112  const (
   113  	IntrospectWhereFilterFields       = "An object containing filter options for a network Fetch search, used to convert the result to the specified filters"
   114  	IntrospectWhereFilterFieldsInpObj = "Filter options for a network Fetch search, used to convert the result to the specified filters"
   115  	IntrospectBeaconId                = "The id of the Beacon"
   116  )
   117  
   118  // GroupBy filter elements
   119  const (
   120  	GroupByGroup  = "Specify the property of the class to group by"
   121  	GroupByCount  = "Get the number of instances of a property in a group"
   122  	GroupBySum    = "Get the sum of the values of a property in a group"
   123  	GroupByMin    = "Get the minimum occurring value of a property in a group"
   124  	GroupByMax    = "Get the maximum occurring value of a property in a group"
   125  	GroupByMean   = "Get the mean value of a property in a group"
   126  	GroupByMedian = "Get the median of a property in a group"
   127  	GroupByMode   = "Get the mode of a property in a group"
   128  )
   129  
   130  // Request timeout filter elements
   131  const NetworkTimeout = "Specify the time in seconds after which an unresolved request automatically fails"
   132  
   133  // Pagination filter elements
   134  const (
   135  	First = "Show the first x results (pagination option)"
   136  	After = "Show the results after the first x results (pagination option)"
   137  )
   138  
   139  // Cursor API
   140  const (
   141  	AfterID = "Show the results after a given ID"
   142  )
   143  
   144  const (
   145  	SortPath  = "Specify the path from the Objects fields to the property name (e.g. ['Get', 'City', 'population'] leads to the 'population' property of a 'City' object)"
   146  	SortOrder = "Specify the sort order, either ascending (asc) which is default or descending (desc)"
   147  )
   148  
   149  const (
   150  	GroupByFilter          = "Specify the property of the class to group by"
   151  	GroupByPath            = "Specify the path from the objects fields to the property name (e.g. ['Things', 'City', 'population'] leads to the 'population' property of a 'City' object)"
   152  	GroupByGroups          = "Specify the number of groups to be created"
   153  	GroupByObjectsPerGroup = "Specify the number of max objects in group"
   154  )