Cette page explique comment effectuer des lectures dans Spanner en dehors du contexte des transactions en lecture seule et des transactions de lecture/écriture. Ainsi, vous devriez plutôt lire la page Transactions dans les cas suivants :
Si vous avez besoin d'effectuer une écriture, en fonction de la valeur d'une ou plusieurs lectures, vous devez exécuter la lecture dans le cadre d'une transaction en lecture-écriture. En savoir plus sur les transactions en lecture-écriture
Si vous effectuez plusieurs appels en lecture nécessitant une vue cohérente de vos données, vous devez exécuter les lectures dans le cadre d'une transaction en lecture seule. En savoir plus sur les transactions en lecture seule
Si vous devez effectuer un seul appel en lecture ou lire des données en parallèle sans avoir besoin d'écrire, lisez ce qui suit.
Types de lecture
Spanner vous permet de déterminer le niveau d'actualisation des données lorsque vous les lisez en offrant deux types de lectures:
- La lecture forte qui est une lecture avec un horodatage actuel. Elle garantit l'affichage de toutes les données qui ont été enregistrées jusqu'au début de cette lecture. Spanner utilise par défaut les lectures fortes pour répondre aux requêtes de lecture.
- La lecture non actualisée qui est une lecture avec un horodatage passé. Si votre application est sensible au temps de latence, mais tolère les données passées, les lectures non actualisées peuvent s'avérer avantageuses en termes de performances.
Pour choisir le type de lecture souhaité, définissez une limite d'horodatage dans la requête de lecture. Suivez les bonnes pratiques suivantes lorsque vous choisissez une limite d'horodatage:
Choisissez des lectures fortes autant que possible. Il s'agit de la limite d'horodatage par défaut pour les lectures Spanner, y compris les transactions en lecture seule. Il est garanti que les lectures fortes tiennent compte des effets de toutes les transactions enregistrées avant le début de l'opération, quelle que soit l'instance dupliquée recevant la lecture. De ce fait, les lectures fortes simplifient le code des applications et augmentent la fiabilité de ces dernières. Pour en savoir plus sur les propriétés de cohérence de Spanner, consultez la section TrueTime et cohérence externe.
Si, dans certaines situations, la latence empêche les lectures fortes, préférez les lectures non actualisées (obsolescence limitée ou exacte) pour améliorer les performances lorsque vous n'avez pas besoin de lectures très récentes. Comme décrit dans la réplication de Cloud Spanner, 15 secondes est une valeur d'obsolescence raisonnable à utiliser pour obtenir de bonnes performances.
Lire des données avec un rôle de base de données
Si vous êtes un utilisateur du contrôle des accès ultraprécis, vous devez sélectionner un rôle de base de données pour exécuter des instructions et des requêtes SQL, ainsi que pour effectuer des opérations sur les lignes d'une base de données. Votre sélection de rôle reste affichée tout au long de votre session jusqu'à ce que vous changiez de rôle.
Pour savoir comment effectuer une lecture avec un rôle de base de données, consultez Accéder à une base de données avec un contrôle d'accès précis.
Méthodes de lecture unique
Spanner accepte les méthodes de lecture unique (c'est-à-dire, une lecture en dehors du contexte d'une transaction) sur une base de données pour:
- Exécuter la lecture en tant qu'instruction de requête SQL ou à l'aide de l'API de lecture de Spanner
- effectuer une lecture forte à partir d'une ou de plusieurs lignes d'une table ;
- effectuer une lecture non actualisée à partir d'une ou de plusieurs lignes d'une table ;
- lire à partir d'une ou de plusieurs lignes d'un index secondaire.
Les sections ci-dessous décrivent l'utilisation des méthodes de lecture à l'aide des bibliothèques clientes cloud pour l'API Cloud Spanner.
Exécuter une requête
Pour exécuter une instruction de requête SQL sur une base de données, procédez comme suit :
GoogleSQL
C++
Utilisez ExecuteQuery()
pour exécuter une instruction de requête SQL sur une base de données.
C#
Utilisez ExecuteReaderAsync()
pour interroger la base de données.
Go
Utilisez Client.Single().Query
pour interroger la base de données.
Java
Utilisez ReadContext.executeQuery
pour interroger la base de données.
Node.js
Utilisez Database.run
pour interroger la base de données.
PHP
Utilisez Database::execute
pour interroger la base de données.
Python
Utilisez Database.execute_sql
pour interroger la base de données.
Ruby
Utilisez Client#execute
pour interroger la base de données.
Pour créer une instruction SQL, consultez les documentations de référence de SQL sur la Syntaxe des requêtes et les Fonctions et opérateurs.
Effectuer une lecture forte
Pour effectuer une lecture forte de zéro ou plusieurs lignes d'une base de données, procédez comme suit.
GoogleSQL
C++
Le code permettant de lire des données est identique à l'exemple précédent permettant d'interroger Spanner en exécutant une requête SQL.
C#
Le code permettant de lire des données est identique à l'exemple précédent permettant d'interroger Spanner en exécutant une requête SQL.
Go
Utilisez Client.Single().Read
pour lire les lignes de la base de données.
L'exemple utilise la valeur AllKeys
pour définir une collection de clés ou de plages de clés à lire.
Java
Utilisez ReadContext.read
pour lire les lignes de la base de données.
L'exemple utilise la valeur KeySet
pour définir une collection de clés ou de plages de clés à lire.
Node.js
Utilisez Table.read
pour lire les lignes de la base de données.
L'exemple utilise la valeur keySet
pour définir une collection de clés ou de plages de clés à lire.
PHP
Utilisez Database::read
pour lire les lignes de la base de données.
L'exemple utilise la valeur keySet
pour définir une collection de clés ou de plages de clés à lire.
Python
Utilisez Database.read
pour lire les lignes de la base de données.
L'exemple utilise la valeur KeySet
pour définir une collection de clés ou de plages de clés à lire.
Ruby
Utilisez Client#read
pour lire les lignes de la base de données.
Effectuer une lecture non actualisée
L'exemple de code suivant montre comment effectuer une lecture non actualisée de zéro ou plusieurs lignes d'une base de données à l'aide d'une limite d'horodatage d'obsolescence exacte. Pour savoir comment effectuer une lecture non actualisée à l'aide d'un horodatage d'obsolescence limitée, consultez la remarque qui suit l'exemple de code. Pour en savoir plus sur les différents types de limites d'horodatage disponibles, consultez la section Limites d'horodatage.
GoogleSQL
C++
Utilisez ExecuteQuery()
avec MakeReadOnlyTransaction()
et Transaction::ReadOnlyOptions()
pour effectuer une lecture non actualisée.
C#
Interrogez la base de données à l'aide de la méthode BeginReadOnlyTransactionAsync
sur une connexion connection
en spécifiant la valeur TimestampBound.OfExactStaleness()
.
Go
Pour lire les lignes de la base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, exécutez la requête Client.ReadOnlyTransaction().WithTimestampBound()
et spécifiez la valeur ExactStaleness
.
L'exemple utilise la valeur AllKeys
pour définir une collection de clés ou de plages de clés à lire.
Java
Pour lire les lignes d'une base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, utilisez la méthode read
de ReadContext
et spécifiez la valeur TimestampBound.ofExactStaleness()
.
L'exemple utilise la valeur KeySet
pour définir une collection de clés ou de plages de clés à lire.
Node.js
Pour lire les lignes de la base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, utilisez Table.read
avec l'option exactStaleness
.
L'exemple utilise la valeur keySet
pour définir une collection de clés ou de plages de clés à lire.
PHP
Pour lire les lignes de la base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, utilisez Database::read
en spécifiant la valeur exactStaleness
.
L'exemple utilise la valeur keySet
pour définir une collection de clés ou de plages de clés à lire.
Python
Pour lire les lignes d'une base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, utilisez la méthode read
de Database
snapshot
et spécifiez la valeur exact_staleness
.
L'exemple utilise la valeur KeySet
pour définir une collection de clés ou de plages de clés à lire.
Ruby
Pour lire les lignes d'une base de données à l'aide d'une limite d'horodatage d'obsolescence exacte, utilisez la méthode read
de l'instantané Client
et spécifiez la valeur staleness
(en secondes).
Effectuer une lecture à l'aide d'un index
Pour lire zéro ou plusieurs lignes d'une base de données à l'aide d'un index, procédez comme suit.
GoogleSQL
C++
Utilisez la fonction Read()
pour effectuer une lecture à l'aide d'un index.
C#
Lisez des données à l'aide de l'index en exécutant une requête qui spécifie explicitement l'index :
Go
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête Client.Single().ReadUsingIndex
.
Java
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête ReadContext.readUsingIndex
.
Node.js
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête Table.read
en y spécifiant l'index.
PHP
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête Database::read
en y spécifiant l'index.
Python
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête Database.read
en y spécifiant l'index.
Ruby
Pour lire les lignes de la base de données à l'aide d'un index, exécutez la requête Client#read
en y spécifiant l'index.
Lire des données en parallèle
Lorsque vous effectuez des opérations de lecture ou de requête groupées impliquant de très grandes quantités de données en provenance de Spanner, vous pouvez utiliser l'API PartitionQuery pour accélérer les résultats. L'API divise la requête en parties plus petites, ou partitions, en utilisant plusieurs machines pour extraire les partitions en parallèle. Sachez que l'utilisation de l'API PartitionQuery entraîne une latence plus élevée, car elle n'est destinée qu'aux opérations groupées, telles que l'exportation ou l'analyse de l'ensemble de la base de données.
Vous pouvez effectuer n'importe quelle opération d'API de lecture en parallèle à l'aide des bibliothèques clientes Spanner. Toutefois, vous ne pouvez partitionner les requêtes SQL que si le premier opérateur du plan d'exécution de la requête est une union distribuée. Pour afficher le plan d'exécution d'une requête SQL en particulier, suivez les instructions de la section Bonnes pratiques relatives aux instructions SQL.
Une fois que vous disposez du plan d'exécution de la requête, assurez-vous que le premier opérateur qu'il contient est une union distribuée.
GoogleSQL
C++
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer une transaction par lot Spanner
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
C#
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer une transaction par lot Spanner
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
Go
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client Spanner et une transaction
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
Java
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client par lot Spanner et une transaction
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
Node.js
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client Spanner et un lot
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
PHP
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client Spanner et un lot
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
Python
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client Spanner et une transaction par lot
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition
Ruby
Cet exemple extrait les partitions d'une requête SQL de la table Singers
et exécute la requête sur chaque partition en procédant comme suit:
- Créer un client par lot Spanner
- Création de partitions pour la requête, afin que les partitions puissent être réparties sur plusieurs nœuds de calcul
- Extraction des résultats de la requête pour chaque partition