Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O pool de conexões permite o uso de pools de conexões pré-configurados nos dialetos de banco de dados PostgreSQL e Snowflake.
Se o seu dialeto oferecer suporte, o pool de conexões de banco de dados permite que o Looker use pools de conexões pelo driver JDBC. O pooling de conexões de banco de dados permite uma performance de consulta mais rápida. Uma nova consulta não precisa criar uma nova conexão de banco de dados, mas pode usar uma conexão existente do pool de conexões. O recurso de agrupamento de conexões garante que uma conexão seja limpa após a execução de uma consulta e fique disponível para reutilização após o término da execução.
A opção Agrupamento de conexões de banco de dados está ativada na conexão do Looker.
Você configurou pools de conexões no seu banco de dados.
Veja alguns pontos a serem considerados ao usar pools de conexão:
Vários usuários compartilham um pool de conexões se os valores dos atributos do usuário forem idênticos. Os usuários que têm valores únicos ou diferentes no conjunto de atributos do usuário usam pools de conexão exclusivos ao se conectar ao banco de dados.
O número máximo de conexões que podem ser feitas em pools de conexões em todos os nós do banco de dados é limitado pelo valor no campo Conexões máximas por nó na página Conexão do banco de dados.
Se o número de consultas simultâneas emitidas para um pool de conexões exceder o número máximo de conexões, as consultas serão enfileiradas no Looker até que as consultas anteriores sejam executadas.
Strings de conexão JDBC exclusivas criam pools de conexão exclusivos. Por exemplo, nomes de usuários ou de grupos de bancos de dados exclusivos que determinam o controle de acesso baseado em função ao banco de dados vão criar strings de conexão JDBC exclusivas, que, por sua vez, criam pools de conexões exclusivos. Por exemplo, um grupo financeiro em uma empresa pode ter uma função de banco de dados que concede acesso a todas as tabelas, mas a equipe de vendas e marketing pode ter uma função que concede acesso apenas a um subconjunto das tabelas do banco de dados. Nesse caso, cada grupo teria uma string de conexão JDBC e um pool de conexões exclusivos. Um terceiro grupo pode ser um conjunto de clientes de análise integrada que têm direitos de acesso próprios ao banco de dados. Os clientes da Análises incorporadas também teriam uma string JDBC exclusiva e um pool de conexões exclusivo, ou seja, um conjunto exclusivo de conexões que não estão em uso pelos grupos de finanças ou de vendas e marketing.
A cláusula WHERE em uma consulta SQL não causa novos pools de conexão. A cláusula WHERE não tem impacto na string de conexão JDBC, portanto, um novo pool de conexões não é criado. Por exemplo, filtros de acesso únicos modificam a cláusula WHERE do SQL em uma consulta, e não a string de conexão JDBC. Portanto, eles não criam novos pools de conexão.
Quando vários pools de conexões são criados, o número máximo de conexões é fragmentado em vários pools, e cada pool contém um subconjunto de conexões disponíveis. Isso ocorre porque o número total de conexões não pode exceder o valor máximo.
Suporte a dialeto para pool de conexões de banco de dados
A capacidade de usar o pool de conexões do banco de dados depende do dialeto do banco de dados que a conexão do Looker está usando. Na versão mais recente do Looker, os seguintes dialetos são compatíveis com o pool de conexões de banco de dados:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Database connection pooling\n\nConnection pooling enables the use of preconfigured connection pools on [PostgreSQL](/looker/docs/db-config-postgresql) and [Snowflake](/looker/docs/db-config-snowflake) database dialects.\n\n[If your dialect supports it](#dialect_support_for_database_connection_pooling), database connection pooling enables Looker to use pools of connections through the JDBC driver. Database connection pooling enables faster query performance; a new query does not need to create a new database connection but can instead use an existing connection from the connection pool. The connection pooling capability ensures that a connection is cleaned up after a query execution and is available for reuse after the query execution ends.\n\nYou can enable connection pooling using the [**Database Connection Pooling**](/looker/docs/admin-panel-general-labs#database_connection_pooling) option when you [create](/looker/docs/connecting-to-your-db) or [edit](/looker/docs/admin-panel-database-connections#editing_connections) a database connection in Looker.\n| **Note:** Database connection pooling was previously a Looker [Labs](/looker/docs/admin-panel-general-labs) feature. When **Database Connection Pooling** moved out of Labs, Looker automatically applied the **Database Connection Pooling** Labs setting to the **Database Connection Pooling** connection setting for any database connections on your instance that support connection pooling.\n\nLooker will use connection pooling on your connection if all of the following are true:\n\n- You are using one of the [dialects that support database connection pooling](#dialect_support_for_database_connection_pooling).\n- The **Database Connection Pooling** option is enabled on the Looker connection.\n- You have configured connection pools on your database.\n\nHere are some things to consider when you're using connection pools:\n\n- Multiple users share a connection pool if their user attribute values are identical. Users who have unique or differing values in their set of user attributes will use unique connection pools when connecting to the database.\n\n- The maximum number of connections that can be made to connection pools across all database nodes is limited by the value in the [**Max connections per node**](/looker/docs/connecting-to-your-db#max_connections) field in the database's **Connection** page.\n\n- If the number of concurrent queries being issued to a connection pool exceeds the maximum number of connections, queries are queued in Looker until prior queries are executed.\n\n- Unique JDBC connection strings create unique connection pools. For example, unique database usernames or database group names that dictate role-based access control to the database will create unique JDBC connection strings, which then create unique connection pools. For example, a finance group in a company may have a database role that grants them access to all tables in the database, but the sales and marketing team may have a database role that grants them access to only a subset of the database tables. In this case, each group would have a unique JDBC connection string and a unique connection pool. A third group might be a set of [embedded analytics](/looker/docs/single-sign-on-embedding) customers who have their own access rights to the database. The embedded analytics customers would also have a unique JDBC string and a unique connection pool, so they would also have a unique set of connections that are not in use by the finance or sales and marketing groups.\n\n- The `WHERE` clause in a SQL query does not cause new connection pools. The `WHERE` clause has no impact on the JDBC connection string, so a new connection pool is not created. For example, unique [access filters](/looker/docs/reference/param-explore-access-filter) modify the SQL `WHERE` clause in a query, not the JDBC connection string, so unique access filters won't create new connection pools.\n\n- When multiple connection pools are created, the maximum number of connections is fragmented into multiple pools, with each pool containing a subset of available connections. This occurs because the total number of connections cannot exceed the maximum connections value.\n\nDialect support for database connection pooling\n-----------------------------------------------\n\nThe ability to use database connection pooling depends on the database dialect your Looker connection is using. In the latest release of Looker, the following dialects support database connection pooling:"]]
