psql
est l'interface de ligne de commande de PostgreSQL. Cette page décrit les psql
compatibles avec l'interface PostgreSQL pour Spanner. Pour savoir comment vous connecter à psql
, consultez Connecter psql à une base de données en dialecte PostgreSQL.
Commandes Meta
L'interface PostgreSQL accepte les catégories de méta-commandes psql
suivantes:
- Général
- Aide
- Tampon de requête
- Input/Output
- Conditionnel
- À titre informatif (certaines commandes \d uniquement)
- Mise en forme
- Système d'exploitation
- Variables
Les catégories suivantes ne sont pas acceptées:
- Connexion
- Objets volumineux
Les commandes informatives suivantes sont acceptées:
Commande | Description |
---|---|
\d | Répertorier les tables (à l'exclusion des tables système) |
\d table | Répertorier les colonnes d'une table |
\dt | Répertorier les tables de tous les schémas (en détail) |
\dt table | Répertorier les tables (en détail) |
\dn | Lister les schémas |
Instructions de gestion de session
psql
communique avec Spanner via PGAdapter,
qui utilise le moteur principal du pilote JDBC Spanner. Le conducteur
prend en charge les instructions de gestion des sessions décrites dans
Instructions de gestion des sessions.
Vous pouvez donc utiliser ces instructions avec psql
.
Requêtes SQL par lot
psql
et PGAdapter sont compatibles avec les lots SQL à plusieurs instructions. Pour regrouper des instructions, vous devez utiliser l'option psql -c
. Cette option permet d'utiliser une ou plusieurs requêtes SQL ou la gestion de session
, séparées par un point-virgule (;), à transmettre en tant que requête d'exécution unique.
Un lot peut inclure toutes les instructions compatibles, et peut combiner des instructions LDD, LMD et DQL.
Un lot avec plusieurs instructions est exécuté dans un seul bloc de transaction implicite. Les blocs de transactions implicites sont automatiquement fermés à la fin du lot. Si des erreurs se produisent à l'intérieur d'un bloc de transaction implicite, l'intégralité la transaction est annulée.
BEGIN
et
Les contrôles des transactions COMMIT
sont acceptés, mais un blocage de transaction explicite
ne peut pas contenir d'instructions LDD.
Examples
LMD
L'exemple suivant montre comment envoyer un lot d'instructions INSERT
.
psql -h localhost -p 5432 -c "INSERT INTO users (id, age, firstname) VALUES (1, 25, 'Alex'); \
INSERT INTO users (id, age, firstname) VALUES (2, 31, 'Dana'); \
INSERT INTO users (id, age, firstname) VALUES (3, 54, 'Izumi');"
L'exemple suivant montre comment exécuter les instructions SQL dans le fichier insert_contacts.sql
.
psql -h localhost -c "$(cat contacts_insert.sql)"
LDD
Cet exemple envoie un lot d'instructions ALTER TABLE
.
psql -h localhost -p 5432 test-db -c "ALTER TABLE users ADD col1 integer; \
ALTER TABLE users ADD col2 text; ALTER TABLE users ADD col3 float8;"
Commande COPY pour importer des données
Utilisez la commande COPY FROM STDIN
pour importer des données à partir d'un fichier texte ou CSV dans une base de données en dialecte PostgreSQL. Bien que seule l'entrée standard STDIN soit prise en charge, vous pouvez importer à l'aide de COPY
en transmettant des fichiers dans psql
.
Il existe deux façons d'exécuter la commande COPY
:
COPY
atomiqueLes données sont copiées en une seule transaction. Il s'agit de la valeur par défaut. Les limites de transaction standards de Spanner s'appliquent à la transaction. Cela signifie que tout au plus 80 000 mutations ou 100 Mo de données peuvent être inclus en une seule opération
COPY
.COPY
non atomiqueCOPY
divise automatiquement les données sur plusieurs Transactions si le fichier contient plus de 80 000 mutations supérieure à 100 Mo.Si une erreur se produit pendant
COPY
et que l'opération est abandonnée, certaines lignes peuvent déjà être persistées dans la base de données. Aucun rollback n'a lieu. Les transactions sont exécutées en parallèle, de sorte que les données situées après la ligne dans l'importation le fichier à l'origine de l'erreur peut être importé dans la base de données avant l'opérationCOPY
est interrompue.
Activer les COPY
non atomiques
Pour activer une COPY
non atomique, envoyez la commande suivante avant d'exécuter la copie
opération.
SET SPANNER.AUTOCOMMIT_DML_MODE='PARTITIONED_NON_ATOMIC'
Syntaxe
COPY table_name [ ( column_name [, ...] ) ] FROM STDIN [ [ WITH ] ( option [, ...] ) ] where option is one of: FORMAT format_name DELIMITER 'delimiter_character' NULL 'null_string' QUOTE 'quote_character' ESCAPE 'escape_character' HEADER [boolean] and format_name is: {text|csv} and delimiter_character is: [!-~] except ' " \ and null_string is: {a—z|A—Z|0—9|_}+ and quote_character is: [!-~] except ' " \ and escape_character is: [!-~] except ' " \ and boolean is: {TRUE|ON|1|FALSE|OFF|0}
Le tableau doit déjà exister. Si aucune liste de colonnes n'est spécifiée, toutes les colonnes du tableau sont copiées.
La valeur par défaut pour FORMAT
est text
.
caractère_délimiteur doit être un caractère de 1 octet. Par défaut, le caractère de tabulation est utilisé pour le format texte et la virgule pour le format CSV.
NULL
spécifie la chaîne représentant une valeur nulle. La valeur par défaut est \N (barre oblique inverse+N) au format texte et une chaîne vide sans guillemets au format CSV. Vous pouvez préférer une chaîne vide même au format texte pour les cas où vous ne voulez pas distinguer les valeurs nulles des chaînes vides.
QUOTE
spécifie le caractère de guillemets à utiliser lorsqu'une valeur de données est placée entre guillemets. Par défaut, les guillemets doubles sont utilisés. Il doit s'agir d'un caractère unique d'un octet. Cette option n'est autorisée que lorsque vous utilisez le format CSV.
ESCAPE
spécifie le caractère à afficher avant un caractère de données correspondant à la valeur QUOTE
. La valeur par défaut est identique à celle de QUOTE
(de sorte que le caractère de guillemet soit doublé s'il apparaît dans les données). Il doit s'agir d'un caractère unique d'un octet. Cette option n'est autorisée que si vous utilisez le format CSV.
HEADER
indique si le premier enregistrement du fichier d'entrée est un en-tête (contient des noms de colonnes). La valeur par défaut est TRUE.
Examples
Cet exemple importe les données du fichier au format texte mydata.txt
dans la table mytable
. PGAdapter
doivent être en cours d'exécution. Pour en savoir plus, consultez la section Démarrer PGAdapter.
cat mydata.txt | psql -h localhost -c "COPY mytable FROM STDIN;"
Dans l'exemple suivant, mydata.csv
est au format CSV, et sa première ligne est un en-tête avec
de colonnes séparés par une virgule.
cat mydata.csv | psql -h localhost \
-c "COPY mytable FROM STDIN WITH (FORMAT csv, ESCAPE '~', HEADER TRUE);"
L'exemple suivant montre comment démarrer une opération COPY
non atomique.
cat mydata.txt | psql -h localhost \
-c "SET SPANNER.AUTOCOMMIT_DML_MODE='PARTITIONED_NON_ATOMIC'" -c "COPY mytable FROM STDIN;"
Dépannage
Voici quelques erreurs courantes.
Syntaxe d'entrée incorrecte
L'erreur suivante se produit :
Invalid input syntax for type <type>:"<table_name>"
Cette erreur peut se produire lorsque le fichier d'entrée comporte une ligne d'en-tête avec des noms de colonnes et
l'option HEADER
n'a pas été spécifiée.
Données COPY non valides
L'erreur suivante se produit :
Invalid COPY data: Row length mismatched. Expected <number> columns, but only found <number>
Cette erreur se produit lorsqu'une ligne du fichier d'entrée ne contient pas de valeur (ou "null") pour chaque colonne du tableau. L'une des causes peut être un fichier CSV incorrect ou une incohérence entre l'option de délimiteur spécifiée (ou le délimiteur par défaut) et le délimiteur réel dans le fichier.
Étape suivante
- Découvrez comment vous connecter à une base de données de dialecte PostgreSQL avec
psql
. - En savoir plus sur PGAdapter