Interroger le nombre total de lignes d'une table ou renvoyer plusieurs lignes aléatoires - Tablestore

Utilisez la requête MatchAll pour cibler toutes les lignes d'une table afin d'obtenir le nombre total de lignes ou de renvoyer plusieurs lignes aléatoires.

Opération API

Appelez l'opération Search ou ParallelScan et définissez le type de requête sur MatchAllQuery pour exécuter une requête MatchAll.

Paramètres

Paramètre	Description
query	Type de requête. Définissez le paramètre query sur MatchAllQuery.
tableName	Nom de la table de données.
indexName	Nom de l'index de recherche.
limit	Nombre maximal de lignes à renvoyer. Pour renvoyer plusieurs lignes de données aléatoires, définissez le paramètre limit sur un entier positif. Pour obtenir uniquement le nombre de lignes correspondant aux conditions de requête sans récupérer les données, définissez le paramètre limit sur 0.
columnsToGet	Indique s'il faut renvoyer toutes les colonnes de chaque ligne correspondant aux conditions de requête. Vous pouvez spécifier les champs returnAll et columns pour le paramètre columnsToGet. La valeur par défaut du champ returnAll est false, ce qui signifie que toutes les colonnes ne sont pas renvoyées. Dans ce cas, utilisez le champ columns pour spécifier les colonnes à renvoyer. Si vous ne spécifiez pas les colonnes à renvoyer, seules les colonnes de clé primaire sont retournées. Si vous définissez le champ returnAll sur true, toutes les colonnes sont renvoyées.
getTotalCount	Indique s'il faut renvoyer le nombre total de lignes correspondant aux conditions de requête. La valeur par défaut de ce paramètre est false, ce qui signifie que le nombre total de lignes correspondantes n'est pas renvoyé. Si vous définissez ce paramètre sur true, les performances de la requête sont dégradées.

Méthodes

Utilisez la CLI Tablestore ou les SDK Tablestore pour exécuter une requête MatchAll. Avant de commencer, assurez-vous d'avoir effectué les préparatifs suivants :

Utilisez un compte Alibaba Cloud ou un utilisateur RAM disposant des autorisations nécessaires pour les opérations Table Store. Pour accorder des autorisations à un utilisateur RAM, consultez la rubrique Accorder des autorisations à un utilisateur RAM à l'aide d'une stratégie RAM.

Si vous utilisez un SDK ou un outil en ligne de commande, créez un AccessKey pour votre compte Alibaba Cloud ou votre utilisateur RAM si vous n'en possédez pas déjà un.
Vous avez créé une table de données.
Un Search Index a été créé pour la table de données.
Si vous utilisez un SDK, initialisez le client Tablestore.
Si vous utilisez l'outil en ligne de commande, téléchargez et démarrez l'outil, puis configurez la connexion à votre instance et sélectionnez la table cible. Pour plus d'informations, consultez les rubriques Télécharger l'outil en ligne de commande, Démarrer l'outil et configurer les informations de connexion et Opérations sur les tables de données.

Utiliser la CLI Tablestore

Utilisez la CLI Tablestore pour exécuter la commande search afin d'interroger des données à l'aide d'index de recherche. Pour plus d'informations, consultez la rubrique Index de recherche.

Exécutez la commande search pour utiliser l'index de recherche search_index afin d'interroger les données et renvoyer toutes les colonnes indexées de chaque ligne correspondant aux conditions de requête.
```
search -n search_index --return_all_indexed
```

Saisissez les conditions de requête comme indiqué dans l'invite :

{
    "Offset": -1,
    "Limit": 10,
    "Collapse": null,
    "Sort": null,
    "GetTotalCount": true,
    "Token": null,
    "Query": {
        "Name": "MatchAllQuery",
        "Query": {
        }
    }
}

Utiliser les SDK Tablestore

Vous pouvez exécuter une requête MatchAll à l'aide des SDK Tablestore suivants : SDK Tablestore pour Java, SDK Tablestore pour Go, SDK Tablestore pour Python, SDK Tablestore pour Node.js, SDK Tablestore pour .NET et SDK Tablestore pour PHP. Cet exemple utilise le SDK Tablestore pour Java.

L'exemple suivant correspond à chaque ligne d'un index de recherche et renvoie jusqu'à 10 lignes ainsi que le nombre total de lignes correspondantes.

String tableName = "example_table";
String indexName = "example_index";

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(new MatchAllQuery());
searchQuery.setLimit(10);
searchQuery.setTrackTotalCount(SearchQuery.TRACK_TOTAL_COUNT);

SearchRequest request = new SearchRequest(tableName, indexName, searchQuery);
SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
columnsToGet.setReturnAll(true);
request.setColumnsToGet(columnsToGet);

SearchResponse response = client.search(request);
System.out.println(response.getTotalCount());
System.out.println(response.getRows());

Facturation

L'interrogation de données à l'aide d'un Search Index consomme du débit de lecture. Pour plus d'informations, consultez la rubrique Mesure et facturation de Search Index.

FAQ

Comment interroger le nombre total de lignes d'une table ?

Références

Search Index prend en charge divers types de requêtes pour les interrogations de données multidimensionnelles, notamment la requête Term, la requête Terms, la requête MatchAll, la requête Match, la requête PhraseMatch, la requête Range, la requête Prefix, la requête Suffix, la requête Wildcard, la requête TokenBasedWildcard, la requête Bool, la requête Geo, la requête Nested, la recherche vectorielle et la requête Exists.
Lorsque vous interrogez des données, vous pouvez trier et paginer l'ensemble de résultats ou effectuer un pliage (déduplication).
Pour l'analyse de données, telle que la recherche de valeurs maximales ou minimales, le calcul d'une somme ou le comptage de lignes, vous pouvez utiliser les fonctionnalités d'agrégation statistique ou de requête SQL.
Pour exporter rapidement des données indépendamment de l'ordre de l'ensemble de résultats, vous pouvez utiliser la fonctionnalité Parallel Scan.