Cette page décrit le processus de lecture dans Cloud Spanner hors du contexte des transactions en lecture seule et en 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
Cloud Spanner vous permet de déterminer le niveau d'actualisation des données lorsque vous les lisez en proposant 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. Cloud Spanner se sert par défaut des 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.
Choisir les limites d'horodatage
Pour choisir le type de lecture souhaité, définissez une limite d'horodatage sur la requête de lecture. Appliquez 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 Cloud 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 Cloud 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.
Méthodes de lecture unique
Cloud Spanner propose des méthodes de lecture unique (lecture hors du contexte d'une transaction) sur une base de données pour :
- exécuter la lecture sous forme d'une instruction de requête SQL ou à l'aide de l'API de lecture de Cloud 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 :
SQL standard Google
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.
SQL standard Google
C++
Le code permettant de lire les données est identique à l'exemple précédent sur l'interrogation de Cloud Spanner à l'aide d'une requête SQL.
C#
Le code permettant de lire les données est identique à l'exemple précédent sur l'interrogation de Cloud Spanner à l'aide d'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.
SQL standard Google
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.
SQL standard Google
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 sur de très grandes quantités de données depuis Cloud Spanner, vous pouvez utiliser l'API PartitionQuery pour obtenir des résultats plus rapidement. L'API divise la requête en morceaux plus petits, ou partitions, en utilisant plusieurs machines pour extraire les partitions en parallèle. Notez que l'utilisation de l'API PartitionQuery entraîne une latence plus élevée, car elle est uniquement destinée à des opérations groupées telles que l'exportation ou l'analyse de l'intégralité 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 de Cloud 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 bien une union distribuée.
SQL standard Google
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éation d'une transaction par lots Cloud 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éation d'une transaction par lots Cloud 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éation d'un client Cloud Spanner et d'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éation d'un client par lots Cloud Spanner et d'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éation d'un client Cloud Spanner et d'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éation d'un client Cloud Spanner et d'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éation d'un client Cloud Spanner et d'une transaction par lots
- 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éation d'un client par lots Cloud 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