Tous les produits
Search
Centre de documentation

OpenSearch:Primary key-based query

Dernière mise à jour :Aug 20, 2026

URL

/vector-service/fetch

  • L'URL n'inclut ni les en-têtes de requête ni les détails d'encodage.

  • L'URL n'inclut pas l'adresse hôte de l'application.

  • Pour plus d'informations sur les paramètres de requête de l'URL ci-dessus, consultez la section Paramètres de requête ci-dessous.

Protocole de requête

HTTP

Méthode de requête

POST

Format pris en charge

JSON

Signature de requête

Utilisez la méthode suivante pour calculer la signature de requête. La signature de requête est stockée dans l'en-tête authorization.

Paramètre

Type

Description

accessUserName

string

Le nom d'utilisateur se trouve sous Instance Details page > Network Information.

accessPassWord

string

Modifiez le mot de passe sur la page Instance Details, dans la section Network Information.

import com.aliyun.darabonba.encode.Encoder;
import com.aliyun.darabonbastring.Client;

public class GenerateAuthorization {
 public static void main(String[] args) throws Exception {
 String accessUserName = "username";
 String accessPassWord = "password";
 String realmStr = "" + accessUserName + ":" + accessPassWord + "";
 String authorization = Encoder.base64EncodeToString(Client.toBytes(realmStr, "UTF-8"));
 System.out.println(authorization);
 }
}

Format valide pour la valeur de l'en-tête authorization :

cm9vdDp******mdhbA==

Lorsque vous définissez l'en-tête authorization dans une requête HTTP, ajoutez le préfixe Basic .

Exemple : ajout d'un en-tête

authorization: Basic cm9vdDp******mdhbA==

Syntaxe du corps de la requête

Paramètre

Description

Type

Obligatoire

tableName

Nom de la table.

string

Oui

ids

Liste des ID

list[string]

Oui

Exemple de requête de données pour le champ de clé primaire spécifié :

{
    "tableName": "gist",
    "ids": [
        "1",
        "2",
        "3"
    ]
}

Paramètres de réponse

Nom du champ

Description

Type

result

Résultats renvoyés.

list[Doc]

totalCount

Nombre de résultats.

int

totalTime

Temps de réponse. Unité : millisecondes.

float

errorCode

Code d'erreur renvoyé en cas d'échec de la requête.

int

errorMsg

Message d'erreur renvoyé en cas d'échec de la requête.

string

Définition d'un document

Nom du champ

Description

Type

id

Champ de clé primaire.

Le type de données est spécifié lors de la création de la table.

vector

Champ de vecteur.

list[float]

fields

Champ d'attribut d'un vecteur.

map<string, FieldType>

Exemple :

{
    "result": [
        {
            "id": "1",
            "vector": [
                0.1,
                0.2,
                0.3
            ],
            "fields": {
                "a": 11
            }
        }
    ],
    "totalCount": 1,
    "totalTime": 1.2
}