Utiliser le SDK Tablestore pour Node.js pour effectuer une requête de plage - Tablestore

Prérequis

Initialisez une instance OTSClient. Pour plus d'informations, consultez la rubrique Initialiser une instance OTSClient.
Créez une table de données et écrivez-y des données. Pour plus d'informations, consultez les rubriques Créer des tables de données et Écrire des données.
Créez un index de recherche pour la table de données. Pour plus d'informations, consultez la rubrique Créer un index de recherche.

Exemples

L'exemple suivant récupère les lignes où Col_Long est supérieur ou égal à 1 et strictement inférieur à 10 (1 <= Col_Long < 10), triées par Col_Long dans l'ordre décroissant.

client.search({
    tableName: TABLE_NAME,
    indexName: INDEX_NAME,
    searchQuery: {
        offset: 0,
        limit: 10,          // Set to 0 to return only the row count, not the data.
        query: {
            queryType: TableStore.QueryType.RANGE_QUERY,
            query: {
                fieldName: "Col_Long",
                rangeFrom: 1,
                includeLower: true,     // >= rangeFrom (equivalent to >=)
                rangeTo: 10,
                includeUpper: false     // < rangeTo (equivalent to <)
            }
        },
        getTotalCount: true // Returns the total row count. May affect query performance.
    },
    columnToGet: {
        // RETURN_ALL: all columns
        // RETURN_SPECIFIED: columns listed in returnNames
        // RETURN_ALL_FROM_INDEX: all columns in the search index
        // RETURN_NONE: primary key columns only
        returnType: TableStore.ColumnReturnType.RETURN_ALL
    }
}, function (err, data) {
    if (err) {
        console.log('error:', err);
        return;
    }
    console.log('success:', JSON.stringify(data, null, 2));
});

Paramètres

Paramètre	Description
tableName	Nom de la table de données.
indexName	Nom de l'index de recherche.
offset	Nombre de lignes à ignorer avant de renvoyer les résultats. Valeur par défaut : 0.
limit	Nombre maximal de lignes à renvoyer. Définissez ce paramètre sur 0 pour renvoyer uniquement le nombre de lignes sans les données.
queryType	Type de requête. Définissez-le sur `TableStore.QueryType.RANGE_QUERY` pour les requêtes de plage.
fieldName	Nom du champ à interroger.
rangeFrom	Borne inférieure de la plage de requête. L'inclusion de cette valeur dépend du paramètre `includeLower`.
rangeTo	Borne supérieure de la plage de requête. L'inclusion de cette valeur dépend du paramètre `includeUpper`.
includeLower	Indique si `rangeFrom` doit être inclus dans les résultats. La valeur `true` équivaut à `>=` ; la valeur `false` équivaut à `>`.
includeUpper	Indique si `rangeTo` doit être inclus dans les résultats. La valeur `true` équivaut à `<=` ; la valeur `false` équivaut à `<`.
getTotalCount	Indique s'il faut renvoyer le nombre total de lignes correspondant à la requête. Valeur par défaut : false. La définition de ce paramètre sur `true` peut affecter les performances de la requête.
columnToGet	Colonnes à renvoyer. Définissez `returnType` sur l'une des valeurs prises en charge et utilisez `returnNames` pour spécifier les colonnes lorsque `returnType` est défini sur `RETURN_SPECIFIED`. Si vous définissez returnType sur TableStore.ColumnReturnType.RETURN_SPECIFIED, configurez returnNames pour spécifier les colonnes à renvoyer. Si vous définissez le paramètre returnType sur TableStore.ColumnReturnType.RETURN_ALL, toutes les colonnes sont renvoyées. Si vous définissez le paramètre returnType sur TableStore.ColumnReturnType.RETURN_ALL_FROM_INDEX, toutes les colonnes de l'index de recherche sont renvoyées. Si vous définissez le paramètre returnType sur TableStore.ColumnReturnType.RETURN_NONE, seules les colonnes de clé primaire sont renvoyées.

FAQ

Références

Les index de recherche prennent en charge les types de requêtes suivants : requête term, requête terms, requête match all, requête match, requête match phrase, requête prefix, requête de plage, requête wildcard, requête booléenne, requête geo, requête nested, requête vector et requête exists. Sélectionnez un type de requête adapté à vos besoins métier.

Pour trier ou paginer les lignes répondant aux conditions de requête, utilisez la fonctionnalité de tri et de pagination. Pour plus d'informations, consultez la rubrique Tri et pagination.

Pour regrouper l'ensemble des résultats en fonction d'une colonne spécifique, utilisez la fonctionnalité de regroupement (distinct). Ainsi, les données du type spécifié n'apparaissent qu'une seule fois dans les résultats de la requête. Pour plus d'informations, consultez la rubrique Regroupement (distinct).
Pour analyser les données d'une table de données, par exemple pour obtenir les valeurs extrêmes, la somme et le nombre total de lignes, effectuez des opérations d'agrégation ou exécutez des instructions SQL. Pour plus d'informations, consultez les rubriques Agrégation et Requête SQL.
Pour obtenir rapidement toutes les lignes répondant aux conditions de requête sans avoir besoin de les trier, appelez les opérations ParallelScan et ComputeSplits afin d'utiliser la fonctionnalité d'analyse parallèle. Pour plus d'informations, consultez la rubrique Analyse parallèle.