Compartir a través de


API de SQL distribuida de Azure Cosmos DB for PostgreSQL

SE APLICA A: Azure Cosmos DB for PostgreSQL (con tecnología de la extensión de base de datos de Citus en PostgreSQL)

Azure Cosmos DB for PostgreSQL incluye características más allá de la instancia estándar de PostgreSQL. A continuación, se muestra una referencia por categorías de funciones y opciones de configuración para:

  • Paralelizar la ejecución de consultas entre particiones.
  • Administrar los datos de las particiones entre varios servidores.
  • Comprimir los datos con el almacenamiento en columnas.
  • Automatizar la creación de particiones de series temporales

Funciones de SQL

Particionamiento

Nombre Descripción
alter_distributed_table Cambiar la columna de distribución, el recuento de particiones o las propiedades de coubicación de una tabla distribuida
citus_copy_shard_placement Reparar una ubicación de partición inactiva mediante datos de una ubicación correcta
citus_schema_distribute Convertir un esquema de PostgreSQL en un esquema distribuido
citus_schema_undistribute Deshacer la acción de citus_schema_distribute
create_distributed_table Convertir una tabla de PostgreSQL en una tabla distribuida (con particiones)
create_reference_table Mantener copias completas de una tabla sincronizadas en todos los nodos
citus_add_local_table_to_metadata Agregar una tabla local a los metadatos para habilitar la consulta desde cualquier nodo
isolate_tenant_to_new_shard Crear una partición que contiene filas con un valor único específico en la columna de distribución
truncate_local_data_after_distributing_table Truncar todas las filas locales después de distribuir una tabla
undistribute_table Deshacer la acción de create_distributed_table o create_reference_table

Reequilibrio de particiones

Nombre Descripción
citus_add_rebalance_strategy Anexar una fila a pg_dist_rebalance_strategy
citus_move_shard_placement Normalmente se usa de forma indirecta durante el reequilibrio de particiones, en lugar de que la llame directamente un administrador de bases de datos.
citus_set_default_rebalance_strategy Cambiar la estrategia denominada por su argumento para que sea la opción predeterminada elegida al reequilibrar particiones
get_rebalance_progress Supervisar los movimientos planeados y ejecutados por rebalance_table_shards
get_rebalance_table_shards_plan Generar la salida de los movimientos de particiones planeados de rebalance_table_shards sin ejecutarlos
rebalance_table_shards Mover las particiones de la tabla dada para distribuirlas uniformemente entre los roles de trabajo

Colocación

Nombre Descripción
create_distributed_function Hacer que la función se ejecute en los roles de trabajo cerca de las particiones coubicadas
update_distributed_table_colocation Actualizar o interrumpir la coubicación de una tabla distribuida

Almacenamiento en columnas

Nombre Descripción
alter_columnar_table_set Cambiar la configuración de una tabla en columnas
alter_table_set_access_method Convertir una tabla entre el almacenamiento en columnas o en montones

Creación de particiones de series temporales

Nombre Descripción
alter_old_partitions_set_access_method Cambiar el método de almacenamiento de las particiones
create_time_partitions Crear particiones de un intervalo determinado para cubrir un intervalo de tiempo determinado
drop_old_time_partitions Quitar todas las particiones cuyos intervalos están antes de una marca de tiempo determinada

Informativo

Nombre Descripción
citus_get_active_worker_nodes Obtener los nombres de host y los números de puerto de los roles de trabajo activos
citus_relation_size Obtener el espacio en disco que usan todas las particiones de la tabla distribuida especificada
citus_remote_connection_stats Mostrar el número de conexiones activas a cada nodo remoto
citus_stat_statements_reset Quitar todas las filas de citus_stat_statements
citus_table_size Obtener el espacio en disco que usan todas las particiones de la tabla distribuida especificada, excepto los índices
citus_total_relation_size Obtener el espacio total en disco utilizado por todas las particiones de la tabla distribuida especificada, incluidos todos los índices y los datos TOAST
column_to_column_name Traducir la columna partkey de pg_dist_partition en un nombre de columna de texto
get_shard_id_for_distribution_column Buscar el identificador de partición asociado a un valor de la columna de distribución

Parámetros del servidor

Ejecución de consultas

Nombre Descripción
citus.all_modifications_commutative Permitir que todos los comandos reclamen un bloqueo compartido
citus.count_distinct_error_rate Optimizar la tasa de errores del recuento aproximado de postgresql-hll
citus.enable_repartition_joins Permitir instrucciones JOIN realizadas en columnas que no son de distribución
citus.enable_repartitioned_insert_select Permitir volver a particionar filas de la instrucción SELECT y transferirlas entre los roles de trabajo para la inserción
citus.limit_clause_row_fetch_count Número de filas que se van a capturar por tarea para la optimización de las cláusulas de límite
citus.local_table_join_policy Dónde se mueven los datos al realizar una combinación entre tablas locales y distribuidas
citus.multi_shard_commit_protocol Protocolo de confirmación que se va a usar al ejecutar COPY en una tabla con distribución por hash
citus.propagate_set_commands Qué comandos SET se propagan desde el coordinador a los roles de trabajo
citus.create_object_propagation Comportamiento de las instrucciones CREATE en transacciones para objetos admitidos
citus.use_citus_managed_tables Permite acceder a tablas locales en consultas de nodo de trabajo

Informativo

Nombre Descripción
citus.explain_all_tasks Hacer que la salida de EXPLAIN muestre todas las tareas
citus.explain_analyze_sort_method Método de ordenación de las tareas en la salida de EXPLAIN ANALYZE
citus.log_remote_commands Consultas de registro que el coordinador envía a los nodos de trabajo
citus.multi_task_query_log_level Nivel de registro para cualquier consulta que genere más de una tarea
citus.stat_statements_max Número máximo de filas que se van a almacenar en citus_stat_statements
citus.stat_statements_purge_interval Frecuencia con la que el demonio de mantenimiento quita de citus_stat_statements los registros que no son coincidentes en pg_stat_statements
citus.stat_statements_track Habilitar o deshabilitar el seguimiento de instrucciones
citus.show_shards_for_app_name_prefixes Permite mostrar particiones para los clientes seleccionados que quieran verlas
citus.override_table_visibility Habilitar o deshabilitar la ocultación de particiones

Administración de conexiones entre nodos

Nombre Descripción
citus.executor_slow_start_interval Tiempo de espera, en milisegundos, entre la apertura de conexiones al mismo nodo de trabajo
citus.force_max_query_parallelization Abrir tantas conexiones como sea posible
citus.max_adaptive_executor_pool_size Número máximo de conexiones de rol de trabajo por sesión
citus.max_cached_conns_per_worker Número de conexiones que se mantienen abiertas para acelerar los comandos posteriores
citus.node_connection_timeout Duración máxima (en milisegundos) que se debe esperar para el establecimiento de la conexión

Transferencia de datos

Nombre Descripción
citus.enable_binary_protocol Usar el formato de serialización binaria de PostgreSQL (si procede) para transferir datos con los roles de trabajo
citus.max_intermediate_result_size Tamaño, en KB, de los resultados intermedios para las CTE y las consultas secundarias que no se pueden insertar

Deadlock

Nombre Descripción
citus.distributed_deadlock_detection_factor Tiempo de espera antes de comprobar los interbloqueos distribuidos
citus.log_distributed_deadlock_detection Indica si se va a registrar el procesamiento relacionado con la detección de interbloqueos distribuidos en el registro del servidor

Tablas del sistema

El nodo de coordinación contiene vistas y tablas de metadatos para ayudarle a ver las propiedades de los datos y la actividad de consultas en el clúster.

Nombre Descripción
citus_dist_stat_activity Consultas distribuidas que se ejecutan en todos los nodos
citus_lock_waits Consultas bloqueadas en todo el clúster
citus_shards Ubicación de cada partición, tipo de tabla a la que pertenece y su tamaño
citus_stat_statements Estadísticas sobre cómo se ejecutan las consultas y para quién
citus_tables Resumen de todas las tablas distribuidas y de referencia
citus_worker_stat_activity Consultas en roles de trabajo, incluidas las tareas en particiones individuales
pg_dist_colocation Qué particiones de tablas se deben colocar juntas
pg_dist_node Información sobre los nodos de trabajo en el clúster
pg_dist_object Objetos, como los tipos y las funciones, que se han creado en el nodo de coordinación y se han propagado a los nodos de trabajo
pg_dist_placement Ubicación de las réplicas de particiones en los nodos de trabajo
pg_dist_rebalance_strategy Estrategias que puede usar rebalance_table_shards para determinar dónde mover particiones
pg_dist_shard Tabla, columna de distribución e intervalos de valores para cada partición
time_partitions Información sobre cada partición administrada por funciones como create_time_partitions y drop_old_time_partitions

Pasos siguientes