Exporter (0) Imprimer
Développer tout

Opération de requête d'enregistrements

Mis à jour: septembre 2012

L'opération de requête retourne les éléments d'une table.

La demande peut être spécifiée comme suit. Remplacez <service_name> par le nom du service mobile et <table_name> par le nom de la table à laquelle vous devez accéder.

 

Verbe HTTP URI de demande Version HTTP

GET

https://<service_name>.azure-mobile.net/tables/<table_name>

HTTP/1.1

Paramètres URI

Windows Azure Mobile Services prend en charge le sous-ensemble des paramètres d'option de requête suivants définis par le protocole OData (Open Data).

 

Paramètre d'URI Ce paramètre est obligatoire Description

$filter

Non

Restreint les éléments retournés en fonction d'un prédicat de filtre.

$inlinecount

Non

Retourne tous les éléments qui peuvent être retournés dans la requête de base sans appliquer de pagination. Vous devez spécifier une valeur allpages pour ce paramètre.

$orderby

Non

Classe les éléments retournés dans une ou plusieurs colonnes. L'ordre peut être croissant (asc), qui est la valeur par défaut, ou décroissant (desc)

$select

Non

Définit une nouvelle projection des données en spécifiant les colonnes incluses dans les données retournées.

$skip

Non

Indique le nombre d'enregistrements de la requête de base qu'il faut ignorer avant de retourner les éléments. Ceci est utilisé pour les résultats de la pagination. Pour plus d'informations, consultez Ajouter la pagination à vos requêtes.

$top

Non

Indique le nombre d'éléments à inclure dans la réponse. Ceci est utilisé pour les résultats de la pagination. Pour plus d'informations, consultez Ajouter la pagination à vos requêtes.

Pour les spécifications de syntaxe des différentes options de requête, consultez la Documentation du protocole OData.

Le paramètre noscript est également pris en charge :

 

Paramètre d'URI Ce paramètre est obligatoire Description

noscript

Non

Lorsqu'une valeur true est fournie, l'exécution des scripts inscrits est supprimée. Pour supprimer l'exécution de scripts, vous devez également fournir la clé principale du service dans l'en-tête X-ZUMO-MASTER.

En-têtes de demande

Le tableau suivant décrit les en-têtes de la demande.

 

En-tête de demande Ce paramètre est obligatoire  

Accept

Non

Définissez cet en-tête avec application/json.

X-ZUMO-APPLICATION

Opérateurs conditionnels

Clé de l'application du service mobile. Vous devez spécifier une clé d'application valide, si requise pour accéder à l'opération de table. Il s'agit de l'autorisation d'accès par défaut à l'opération de table.

X-ZUMO-AUTH

Opérateurs conditionnels

Jeton d'authentification généré par le service pour un utilisateur authentifié. Vous devez spécifier le jeton d'un utilisateur authentifié, si requis pour accéder à l'opération de table.

X-ZUMO-MASTER

Opérateurs conditionnels

Clé principale du service. Vous devez inclure cette clé uniquement lorsque l'accès administrateur est requis pour accéder à l'opération de table.

securitySécurité Remarque
La clé principale du service est une information d'identification de sécurité essentielle qui fournit un accès administrateur à votre service de données. Ne la partagez pas avec d'autres personnes et ne la distribuez pas avec votre application. Cette clé doit toujours être distribuée de façon sécurisée sur un canal chiffré.

Corps de la demande

Aucun.

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Code d'état

Une opération ayant réussi retourne le code d'état 200 (OK).

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

En-tête de réponse Description

Content-Length

Longueur du corps de la réponse.

Content-Type

En-tête défini sur application/json.

x-zumo-version

Indique quelle version du runtime a exécuté la demande.

Corps de la réponse

Représentation JSON du résultat de la requête. Les résultats sont présentés comme un seul objet JSON ou une collection d'objets JSON.

noteRemarque
Lorsque vous ajoutez le paramètre $inlinecount dans votre requête, le JSON dans la réponse est encapsulé par un nouvel objet JSON avec une propriété results, qui inclut les données de résultats en tant que collection d'objets JSON, et une propriété count, qui est le nombre total.

L'autorisation dépend des spécifications d'autorisation d'accès pour l'opération de table, qui sont résumées comme suit :

 

Autorisation d'accès à l'opération de table En-tête d'autorisation requis

Tout le monde

Aucun

Toute personne avec la clé d'application

X-ZUMO-APPLICATION

Seuls les utilisateurs authentifiés

X-ZUMO-AUTH

Seuls les scripts et les administrateurs

X-ZUMO-MASTER

Les autorisations d'accès pour chaque opération de table sont définies dans le portail de gestion Windows Azure. Pour plus d'informations, consultez Autorisations.

Demande de requête filtrée

L'exemple d'URI suivant retourne des objets JSON de la table TodoItem, où la property complète est false.

GET https://todolist.azure-mobile.net/tables/TodoItem?$filter=(complete%20eq%20false)

La demande est envoyée avec les en-têtes suivants.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Host: todolist.azure-mobile.net

Une fois la demande envoyée, la réponse suivante est retournée.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 188

[{"id":1,"text":"Sign-up for the free trial","complete":false},{"id":2,"text":"Create the mobile service","complete":false },
    {"id":3,"text":"Complete the quickstart","complete":false}]

Demande de requête filtrée qui inclut le nombre total

L'exemple d'URI suivant retourne la même requête filtrée, comprenant le nombre total, qui dans ce cas est 3.

GET https://todolist.azure-mobile.net/tables/TodoItem?$filter=(complete%20eq%20false)&$inlinecount=allpages

La demande est envoyée avec les en-têtes suivants.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Host: todolist.azure-mobile.net

Une fois la demande envoyée, la réponse suivante est retournée.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 211

{"results": [{"id":1,"text":"Sign-up for the free trial","complete":false},{"id":2,"text":"Create the mobile service","complete":false },
    {"id":3,"text":"Complete the quickstart","complete":false}],"count":3}

Afficher:
© 2014 Microsoft