Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Fonctions de base de données Aurora Postgre SQL Limitless
Le tableau suivant présente les nouvelles fonctions de la base de données Aurora Postgre SQL Limitless.
Note
Les fonctions répertoriées dans ce tableau se trouvent dans le rds_aurora schéma. Lorsque vous utilisez une fonction de base de données illimitée, assurez-vous d'inclure le nom complet de l'objet :rds_aurora. .object_name
| Fonction de base de données Aurora Postgre SQL Limitless | Fonction Aurora Postgre SQL correspondante |
|---|---|
| limitless_backend_dsid | pg_backend_pid |
| annulation_session illimitée | pg_cancel_backend |
| limitless_stat_clear_snapshot | pg_stat_clear_snapshot |
| taille_de_base_stat_limite_base de données | pg_database_size |
| limitless_stat_get_snapshot_timestamp | pg_stat_get_snapshot_timestamp |
| limitless_stat_prepared_xacts | pg_prepared_xacts |
| tailles_stat_relation_illimitées | pg_indexes_size, pg_relation_size, pg_table_size, pg_total_relation_size |
| limitless_stat_reset | pg_stat_reset |
| limitless_stat_statements_reset | pg_stat_statements_reset |
| limitless_stat_system_waits | aurora_stat_system_waits |
| termination_session illimitée | pg_terminate_backend |
| rapport d'attente illimité | aurora_wait_report |
Les exemples suivants fournissent des détails sur les fonctions de la base de données Aurora Postgre SQL Limitless. Pour plus d'informations sur les SQL fonctions Postgre, consultez la section Fonctions et opérateurs
- limitless_backend_dsid
-
La
limitless_backend_dsidfonction renvoie l'ID de session distribué pour la session en cours. Une session distribuée s'exécute sur un routeur d'un groupe de partitions de base de données et implique des processus principaux sur une ou plusieurs partitions du groupe de partitions de base de données.L'exemple suivant montre comment utiliser la
limitless_backend_dsidfonction.SELECT rds_aurora.limitless_backend_dsid(); limitless_backend_dsid ------------------------ 8CACD7B04D0FC2A5 (1 row) - annulation_session illimitée
-
La
limitless_cancel_sessionfonction fonctionne de la même manière quepg_cancel_backend, mais elle essaie d'annuler tous les processus principaux liés à l'ID de session distribué fourni en envoyant unSIGINT(signal d'interruption).Le paramètre d'entrée est le suivant :
-
distributed_session_id(texte) — L'ID de la session distribuée à annuler.
Les paramètres de sortie sont les suivants :
-
subcluster_id(texte) — L'ID du sous-cluster auquel appartient ce processus. -
pid(texte) — L'ID du processus principal. -
success(booléen) — Indique si l'annulation a été réussie.
L'exemple suivant montre comment utiliser la
limitless_cancel_sessionfonction.SELECT * FROM rds_aurora.limitless_cancel_session('940CD5C81E3C796B'); subcluster_id | pid | success ---------------+-------+--------- 1 | 26920 | t (1 row) -
- limitless_stat_clear_snapshot
-
La
limitless_stat_clear_snapshotfonction supprime l'instantané des statistiques actuelles ou les informations mises en cache sur tous les nœuds.L'exemple suivant montre comment utiliser la
limitless_stat_clear_snapshotfonction.SELECT rds_aurora.limitless_stat_clear_snapshot(); - taille_de_base_stat_limite_base de données
-
La
limitless_stat_database_sizefonction renvoie les tailles d'une base de données dans le groupe de partitions de base de données.Le paramètre d'entrée est le suivant :
-
dbname(name) — Base de données pour laquelle vous souhaitez obtenir les tailles.
Les paramètres de sortie sont les suivants :
-
subcluster_id(texte) — L'ID du sous-cluster auquel appartient ce processus. -
subcluster_type(texte) — Le type de sous-cluster auquel appartient ce processus :routeroushard. -
db_size— Taille de la base de données de ce sous-cluster en octets.
L'exemple suivant montre comment utiliser la
limitless_stat_database_sizefonction.SELECT * FROM rds_aurora.limitless_stat_database_size('postgres_limitless'); subcluster_id | subcluster_type | db_size ---------------+-----------------+---------- 1 | router | 8895919 2 | router | 8904111 3 | shard | 21929391 4 | shard | 21913007 5 | shard | 21831087 (5 rows) -
- limitless_stat_get_snapshot_timestamp
-
La
limitless_stat_get_snapshot_timestampfonction renvoie l'horodatage de l'instantané des statistiques en cours, ouNULLsi aucun instantané des statistiques n'a été pris. Un instantané est pris la première fois que les statistiques cumulées sont consultées dans le cadre d'une transaction sistats_fetch_consistencyce paramètre est défini sursnapshot. Renvoie une vue consolidée des horodatages des instantanés de tous les nœuds. Lessubcluster_typecolonnessubcluster_idet indiquent de quel nœud proviennent les données.L'exemple suivant montre comment utiliser la
limitless_stat_get_snapshot_timestampfonction.SELECT * FROM rds_aurora.limitless_stat_get_snapshot_timestamp(); subcluster_id | subcluster_type | snapshot_timestamp ---------------+-----------------+-------------------- 1 | router | 2 | router | 3 | shard | 4 | shard | 5 | shard | (5 rows) - limitless_stat_prepared_xacts
-
La
limitless_stat_prepared_xactsfonction renvoie des informations sur les transactions sur tous les nœuds actuellement préparés pour une validation en deux phases. Pour plus d'informations, consultez pg_prepared_xactsdans la documentation Postgre. SQL L'exemple suivant montre comment utiliser la
limitless_stat_prepared_xactsfonction.postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_prepared_xacts; subcluster_id | subcluster_type | transaction_id | gid | prepared | owner_id | database_id ---------------+-----------------+----------------+------------------------------+-------------------------------+------------+-------------------- 8 | shard | 5815978 | 7_4599899_postgres_limitless | 2024-09-03 15:51:17.659603+00 | auroraperf | postgres_limitless 12 | shard | 4599138 | 7_4599899_postgres_limitless | 2024-09-03 15:51:17.659637+00 | auroraperf | postgres_limitless (2 rows) - tailles_stat_relation_illimitées
-
La
limitless_stat_relation_sizesfonction renvoie les différentes tailles d'une table dans le groupe de partitions de base de données.Les paramètres d'entrée sont les suivants :
-
relnspname(nom) — Le nom du schéma contenant la table. -
relname(name) — Le nom de la table.
Les paramètres de sortie sont les suivants :
-
subcluster_id(texte) — L'ID du sous-cluster auquel appartient ce processus. -
subcluster_type(texte) — Le type de sous-cluster auquel appartient ce processus :routeroushard. -
main_size— Taille en octets de la fourche de données principale de ce nœud. -
fsm_size— Taille en octets de la carte de l'espace libre de la table dans ce nœud. -
vm_size— Taille en octets de la carte de visibilité de la table de ce nœud. -
init_size— Taille en octets de l'initialisation de la table dans ce nœud. -
toast_size— Taille en octets de la table Toast associée à la table de ce fork. -
index_size— Taille en octets de tous les index de la table de ce nœud. -
total_size— Taille en octets de tous les segments de la table dans ce nœud.
L'exemple suivant montre comment utiliser la
limitless_stat_relation_sizesfonction (certaines colonnes sont omises).SELECT * FROM rds_aurora.limitless_stat_relation_sizes('public','customers'); subcluster_id | subcluster_type | main_size | fsm_size | vm_size | toast_size | table_size | total_size ---------------+-----------------+-----------+----------+---------+------------+------------+------------ 1 | router | 0 | 0 | 0 | 0 | 0 | 0 2 | router | 0 | 0 | 0 | 0 | 0 | 0 3 | shard | 4169728 | 4177920 | 1392640 | 1392640 | 11132928 | 11132928 4 | shard | 4169728 | 4177920 | 1392640 | 1392640 | 11132928 | 11132928 5 | shard | 3981312 | 4227072 | 1409024 | 1409024 | 11026432 | 11026432 (5 rows) -
- limitless_stat_reset
-
La
limitless_stat_resetfonction remet à zéro (0) tous les compteurs de statistiques de la base de données actuelle. Si cette optiontrack_functionsest activée, lastats_resetcolonnelimitless_stat_databaseindique la dernière fois que les statistiques ont été réinitialisées pour la base de données. Par défaut, il nelimitless_stat_resetpeut être exécuté que par un superutilisateur. Les autres utilisateurs peuvent obtenir une autorisation en utilisantEXECUTEce privilège.L'exemple suivant montre comment utiliser la
limitless_stat_resetfonction.SELECT tup_inserted, tup_deleted FROM pg_stat_database WHERE datname = 'postgres_limitless'; tup_inserted | tup_deleted --------------+------------- 896 | 0 (1 row) SELECT rds_aurora.limitless_stat_reset(); limitless_stat_reset --------------------- (1 row) SELECT tup_inserted, tup_deleted FROM pg_stat_database WHERE datname = 'postgres_limitless'; tup_inserted | tup_deleted -------------+------------- 0 | 0 (1 row) - limitless_stat_statements_reset
-
La
limitless_stat_statements_resetfonction ignore les statistiques collectées jusqu'à présent enlimitless_stat_statementscorrespondant auxqueryidparamètres spécifiésusernamedbname,distributed_query_id, et. Si aucun paramètre n'est spécifié, la valeur par défaut""ou0(non valide) est utilisée pour chacun d'entre eux, et les statistiques correspondant aux autres paramètres sont réinitialisées. Si aucun paramètre n'est spécifié, ou si tous les paramètres spécifiés le sont""ou0(non valides), la fonction ignore toutes les statistiques. Si toutes les statistiques de lalimitless_stat_statementsvue sont supprimées, la fonction réinitialise également les statistiques de la vue.limitless_stat_statements_infoLes paramètres d'entrée sont les suivants :
-
username(nom) — L'utilisateur qui a demandé la déclaration. -
dbname(nom) — Base de données dans laquelle la requête a été exécutée. -
distributed_query_id(bigint) — L'ID de requête de la requête parent provenant du nœud coordinateur. Cette colonne l'estNULLs'il s'agit de la requête parent. Le nœud coordinateur transmet l'ID de requête distribué aux nœuds participants. Ainsi, pour les nœuds participants, les valeurs de l'ID de requête distribué et de l'ID de requête sont différentes. -
queryid(bigint) — L'ID de requête de l'instruction.
L'exemple suivant montre comment utiliser la
limitless_stat_statements_resetfonction pour réinitialiser toutes les statistiques collectées parlimitless_stat_statements.SELECT rds_aurora.limitless_stat_statements_reset(); -
- limitless_stat_system_waits
-
La
limitless_stat_system_waitsfonction renvoie une vue consolidée des données relatives aux événements d'attente à partir de tous les nœudsaurora_stat_system_waits, qui indique l'activité d'attente à l'échelle du système dans une instance. Lessubcluster_typecolonnessubcluster_idet indiquent de quel nœud proviennent les données.L'exemple suivant montre comment utiliser la
limitless_stat_system_waitsfonction.postgres_limitless=> SELECT * FROM rds_aurora.limitless_stat_system_waits() lssw, pg_catalog.aurora_stat_wait_event() aswe WHERE lssw.event_id=aswe.event_id and aswe.event_name='LimitlessTaskScheduler'; subcluster_id | subcluster_type | type_id | event_id | waits | wait_time | event_name ---------------+-----------------+---------+-----------+--------+--------------+------------------------ 1 | router | 12 | 201326607 | 677068 | 616942216307 | LimitlessTaskScheduler 2 | router | 12 | 201326607 | 678586 | 616939897111 | LimitlessTaskScheduler 3 | shard | 12 | 201326607 | 756640 | 616965545172 | LimitlessTaskScheduler 4 | shard | 12 | 201326607 | 755184 | 616958057620 | LimitlessTaskScheduler 5 | shard | 12 | 201326607 | 757522 | 616963183539 | LimitlessTaskScheduler (5 rows) - termination_session illimitée
-
La
limitless_terminate_sessionfonction fonctionne de la même manière quepg_terminate_backend, mais elle essaie de mettre fin à tous les processus principaux liés à l'ID de session distribué fourni en envoyant unSIGTERM(signal de fin).Le paramètre d'entrée est le suivant :
-
distributed_session_id(texte) — L'ID de la session distribuée à terminer.
Les paramètres de sortie sont les suivants :
-
subcluster_id(texte) — L'ID du sous-cluster auquel appartient ce processus. -
pid(texte) — L'ID du processus principal. -
success(boolean) — Indique si le processus s'est terminé avec succès.
L'exemple suivant montre comment utiliser la
limitless_terminate_sessionfonction.SELECT * FROM rds_aurora.limitless_terminate_session('940CD5C81E3C796B'); subcluster_id | pid | success ---------------+-------+--------- 1 | 26920 | t (1 row) -
- rapport d'attente illimité
-
La
limitless_wait_reportfonction renvoie l'activité des événements d'attente sur une période donnée à partir de tous les nœuds. Lessubcluster_typecolonnessubcluster_idet indiquent de quel nœud proviennent les données.Les paramètres de sortie sont les suivants :
-
subcluster_id(texte) — L'ID du sous-cluster auquel appartient ce processus. -
subcluster_type(texte) — Le type de sous-cluster auquel appartient ce processus :routeroushard.
Les autres colonnes sont les mêmes que dans
aurora_wait_report.L'exemple suivant montre comment utiliser la
limitless_wait_reportfonction.postgres_limitless=> select * from rds_aurora.limitless_wait_report(); subcluster_id | subcluster_type | type_name | event_name | waits | wait_time | ms_per_wait | waits_per_xact | ms_per_xact ---------------+-----------------+-----------+------------+-------+-----------+-------------+--------------- +------------- 1 | router | Client | ClientRead | 57 | 741550.14 | 13009.652 | 0.19 | 2505.237 5 | shard | Client | ClientRead | 54 | 738897.68 | 13683.290 | 0.18 | 2496.276 4 | shard | Client | ClientRead | 54 | 738859.53 | 13682.584 | 0.18 | 2496.147 2 | router | Client | ClientRead | 53 | 719223.64 | 13570.257 | 0.18 | 2429.810 3 | shard | Client | ClientRead | 54 | 461720.40 | 8550.378 | 0.18 | 1559.86 -