Catégories :: Fonctions de chaîne et fonctions binaires (Fonctions AI)

SEARCH_PREVIEW (SNOWFLAKE.CORTEX)¶

Pour un nom de service Cortex Search et une requête donnés, renvoie une réponse du service spécifié.

Syntaxe¶

SNOWFLAKE.CORTEX.SEARCH_PREVIEW(
    '<service_name>',
    '<query_parameters_object>'
)

Copy

Arguments¶

service_name

Nom de votre service Cortex Search. Utilisez le nom complet si le service se trouve dans un schéma différent de la session en cours.

query_parameters_object

Une STRING qui contient un objet JSON qui spécifie les paramètres de requête pour l’appel du service.

Clé	Type	Description	Par défaut
`query`	Chaîne	Votre requête de recherche, pour rechercher dans la colonne de texte du service.	Cet élément est obligatoire.
`columns`	Tableau	Une liste de colonnes séparées par des virgules à renvoyer pour chaque résultat pertinent dans la réponse. Ces colonnes doivent être incluses dans la requête source du service.	Colonne de recherche qui a été spécifiée lors de la création du service.
`filter`	Objet	Un objet de filtre pour filtrer les résultats en fonction des données dans les colonnes `ATTRIBUTES`. Pour une syntaxe détaillée, voir Syntaxe de filtre.	Objet vide
`limit`	Entier	Nombre maximal de résultats à renvoyer dans la réponse.	10

Syntaxe de filtre¶

Cortex Search prend en charge le filtrage sur les colonnes ATTRIBUTES spécifiées dans la commande CREATE CORTEX SEARCH SERVICE.

Cortex Search prend en charge cinq opérateurs de recherche :

TEXT ou NUMERIC égal à : @eq
ARRAY contient : @contains
NUMERIC ou DATE/TIMESTAMP supérieur ou égal à : @gte
NUMERIC ou DATE/TIMESTAMP inférieur ou égal à : @lte
clé principale égalité : @primarykey

Ces opérateurs de correspondance peuvent être composés de différents opérateurs logiques :

@and
@or
@not

Les notes d’utilisation suivantes s’appliquent :

Les correspondances avec les valeurs NaN (« not a number ») de la requête source sont traitées comme décrit dans Valeurs spéciales.
Les valeurs numériques à virgule fixe comportant plus de 19 chiffres (sans les zéros d’en-tête) ne fonctionnent pas avec les opérateurs @eq, @gte ou @lte et ne seront pas renvoyés par ceux-ci.
- Par exemple, si la requête source contient une grande valeur, en l’utilisation de @eq pour rechercher cette valeur exacte ne renverra aucun résultat.
- Ces grandes valeurs peuvent être renvoyées par le filtre global à l’aide de @not (par exemple, alors que @eq X ne renverra aucune valeur pour certaines valeurs élevées de X, @not @eq Y la renverra).
TIMESTAMP et DATE acceptent des valeurs sous la forme : YYYY-MM-DD et, pour les dates sensibles au fuseau horaire : YYYY-MM-DD+HH:MM. Si le décalage du fuseau horaire n’est pas spécifié, la date est interprétée en UTC.
@primarykey est uniquement pris en charge pour les services configurés avec une clé principale. La valeur du filtre doit être un objet JSON mappant chaque colonne de clé principale avec sa valeur correspondante (ou NULL).

Ces opérateurs peuvent être combinés en un seul objet filtre.

Exemple¶

Le filtrage sur les lignes où se trouve une colonne de type chaîne string_col est égal à la valeur value.
```
{ "@eq": { "string_col": "value" } }
```
Copy

Filtrer une ligne avec la clé principale spécifiée,

{ "@primarykey": { "region": "us-west-1", "agent_id": "abc123" } }

Copy

Filtrage sur les lignes où la colonne ARRAY array_col contient de la valeur value.
```
{ "@contains": { "array_col": "arr_value" } }
```
Copy

Filtrage des lignes dont la colonne NUMERIC numeric_col est comprise entre 10,5 et 12,5 (inclus) :

{ "@and": [
  { "@gte": { "numeric_col": 10.5 } },
  { "@lte": { "numeric_col": 12.5 } }
]}

Copy

Filtrer les lignes où la colonne TIMESTAMP timestamp_col est comprise entre 2024-11-19 et 2024-12-19 (inclus).

{ "@and": [
  { "@gte": { "timestamp_col": "2024-11-19" } },
  { "@lte": { "timestamp_col": "2024-12-19" } }
]}

Copy

Composition de filtres avec des opérateurs logiques :

// Rows where the "array_col" column contains "arr_value" and the "string_col" column equals "value":
{
    "@and": [
      { "@contains": { "array_col": "arr_value" } },
      { "@eq": { "string_col": "value" } }
    ]
}

// Rows where the "string_col" column does not equal "value"
{
  "@not": { "@eq": { "string_col": "value" } }
}

// Rows where the "array_col" column contains at least one of "val1", "val2", or "val3"
{
  "@or": [
      { "@contains": { "array_col": "val1" } },
      { "@contains": { "array_col": "val1" } },
      { "@contains": { "array_col": "val1" } }
  ]
}

Copy

Renvoie¶

Renvoie OBJECT qui contient le résultat de votre requête auprès de votre service Cortex Search et un ID de requête unique. Voir l’exemple de sortie dans Exemples.

Notes sur l’utilisation¶

Cette fonction est conçue pour les tests et la validation et entraîne plus de latence que l’utilisation des APIs REST ou Python. Utilisez d’autres méthodes pour traiter des requêtes de recherche dans une application d’utilisateur final qui nécessite une faible latence.
Cette fonction ne fonctionne que sur des arguments constants. Elle n’accepte pas les colonnes de table en entrée.
Cette fonction tronque les résultats de la recherche s’ils dépassent 300 kB. La surface REST autorise les réponses jusqu’à 10MB.

Exemples¶

Cet exemple interroge un service nommé sample_service avec une test query. L’exemple renvoie cinq résultats (au maximum) et inclut les données des colonnes col1 et col2.

SELECT
  SNOWFLAKE.CORTEX.SEARCH_PREVIEW (
      'mydb.mysch.sample_service',
      '{
          "query": "test query",
          "columns": ["col1", "col2"],
          "limit": 3
      }'
  );

Copy

{
  "results":[
      {"col1":"text", "col2":"text"},
      {"col1":"text", "col2":"text"},
      {"col1":"text", "col2":"text"}
  ],
  "request_id":"a27d1d85-e02c-4730-b320-74bf94f72d0d"
}