Un article expliquant en détail comment configurer sql.DB hautes performances dans Go

Cet article est introduit par la colonne tutoriel golang pour présenter comment configurer sql.DB hautes performances dans Go. J'espère qu'il sera utile aux amis dans le besoin !

Il existe de nombreux didacticiels sur le type sql.DB de Go et sur la façon de l'utiliser pour effectuer des requêtes de base de données SQL. Mais la plupart ne couvrent pas les méthodes SetMaxOpenConns(), SetMaxIdleConns() et SetConnMaxLifetime(), que vous pouvez utiliser pour configurer sql.DB et modifier ses performances. sql.DB类型和如何使用它来执行SQL数据库查询的。但大多数内容都没有讲述SetMaxOpenConns(), SetMaxIdleConns() 和 SetConnMaxLifetime()方法， 您可以使用它们来配置sql.DB的行为并改变其性能。

在本文我将详细解释这些设置的作用，并说明它们所能产生的(积极和消极)影响。

开放和空闲连接
一个sql.DB对象就是一个数据库连接池，它包含“正在用”和“空闲的”连接。一个正在用的连接指的是，你正用它来执行数据库任务，例如执行SQL语句或行查询。当任务完成连接就是空闲的。

当您创建sql.DB执行数据库任务时，它将首先检查连接池中是否有可用的空闲连接。如果有可用的连接，那么Go将重用现有连接，并在执行任务期间将其标记为正在使用。如果池中没有空闲连接，而您需要一个空闲连接，那么Go将创建一个新的连接。

SetMaxOpenConns方法

默认情况下，在同一时间打开连接的数量是没有限制(包含使用中+空闲)。但你可以通过SetMaxOpenConns()方法实现自定义限制，如下所示:

// 初始化一个新的连接池
db, err := sql.Open("postgres", "postgres://user:pass@localhost/db")
if err != nil {
    log.Fatal(err)
}

// 设置当前最大开放连接数（包括空闲和正在使用的）为5。
// 如果设置为0代表连接数没有限制，默认是没有限制数量的。
db.SetMaxOpenConns(5)

在这个示例代码中，连接池现在有5个并发打开的连接数。如果所有5个连接都已经被标记为正在使用，并且需要另一个新的连接，那么应用程序将被迫等待，直到5个连接中的一个被释放并变为空闲。

为了说明更改MaxOpenConns的影响，我运行了一个基准测试，将最大打开连接数设置为1、2、5、10和无限。基准测试在PostgreSQL数据库上执行并行的INSERT语句，您可以在这里找到代码。测试结果:

BenchmarkMaxOpenConns1-8                 500       3129633 ns/op         478 B/op         10 allocs/op
BenchmarkMaxOpenConns2-8                1000       2181641 ns/op         470 B/op         10 allocs/op
BenchmarkMaxOpenConns5-8                2000        859654 ns/op         493 B/op         10 allocs/op
BenchmarkMaxOpenConns10-8               2000        545394 ns/op         510 B/op         10 allocs/op
BenchmarkMaxOpenConnsUnlimited-8        2000        531030 ns/op         479 B/op          9 allocs/op
PASS

对于这个基准测试，我们可以看到，允许打开的连接越多，在数据库上执行INSERT操作所花费的时间就越少(打开的连接数为1时，执行速度3129633ns/op，而无限连接：531030ns/op——大约快了6倍)。这是因为允许打开的连接越多，可以并发执行的数据库查询就越多。

SetMaxIdleConns方法
默认情况下，sql.DB允许连接池中最多保留2个空闲连接。你可以通过SetMaxIdleConns()

Dans cet article, j'expliquerai en détail ce que font ces paramètres et expliquerai les effets (positifs et négatifs) qu'ils peuvent avoir.

Connexions ouvertes et inactives

Un objet sql.DB est un pool de connexions à une base de données, qui contient des connexions "en cours d'utilisation" et "inactives". Une connexion active signifie que vous l'utilisez pour effectuer des tâches de base de données, telles que l'exécution d'instructions SQL ou de requêtes de lignes. Une fois la tâche terminée, la connexion est libre.

Lorsque vous créez sql.DB pour effectuer des tâches de base de données, il vérifiera d'abord s'il existe des connexions libres disponibles dans le pool de connexions. Si une connexion est disponible, Go réutilisera la connexion existante et la marquera comme étant utilisée lors de l'exécution de la tâche. S'il n'y a pas de connexion gratuite dans le pool et que vous en avez besoin, Go en créera une nouvelle.


Méthode SetMaxOpenConns

🎜Par défaut, le nombre de connexions ouvertes en même temps est illimité (y compris en utilisation + inactif). Mais vous pouvez implémenter des limites personnalisées via la méthode SetMaxOpenConns() comme indiqué ci-dessous : 🎜

//  初始化一个新的连接池
db, err := sql.Open("postgres", "postgres://user:pass@localhost/db")
if err != nil {
    log.Fatal(err)
}

// 设置最大空闲连接数为5。 将此值设置为小于或等于0将意味着不保留空闲连接。
db.SetMaxIdleConns(5)

🎜 Dans cet exemple de code, le pool de connexions dispose désormais de 5 connexions ouvertes simultanées. Si les 5 connexions sont déjà marquées comme étant utilisées et qu'une autre nouvelle connexion est requise, l'application sera obligée d'attendre que l'une des 5 connexions soit libérée et devienne libre. 🎜🎜Pour illustrer l'impact du changement de MaxOpenConns, j'ai exécuté un benchmark fixant le nombre maximum de connexions ouvertes à 1, 2, 5, 10 et infini. Le benchmark exécute des instructions INSERT parallèles sur une base de données PostgreSQL, vous pouvez trouver le code ici. Résultats des tests : 🎜🎜🎜BenchmarkMaxOpenConns1-8 500 3129633 ns/op 478 B/op 10 allocs/op🎜BenchmarkMaxOpenConns2-8 1000 2181641 ns/op 470 B/op 10 allocs/op🎜BenchmarkMaxOpenConns5-8 2000 859654 ns/op 493 B / op 10 allocs / op🎜benchmarkMaxOpenConns10-8 2000 545394 NS / OP 510 B / OP 10 ALLOCS / OP🎜BENCHMARKMAXOPCONNSUNLIMITED-8 2000 531030 NS / OP 479 B / OP 9 ALLOCS / OP🎜PASS🎜 Blockquote> 🎜for This Test de benchmark, nous pouvons voir que plus les connexions ouvertes sont autorisées, moins il faut de temps pour effectuer l'opération INSERT sur la base de données (lorsque le nombre de connexions ouvertes est de 1, la vitesse d'exécution est de 3129633ns/ op, Et connexion illimitée : 531030ns/op - environ 6 fois plus rapide). En effet, plus vous autorisez l’ouverture de connexions, plus de requêtes de base de données peuvent être exécutées simultanément. 🎜🎜🎜Méthode SetMaxIdleConns🎜🎜Par défaut, sql.DB permet de conserver jusqu'à 2 connexions inactives dans le pool de connexions. Vous pouvez le modifier via la méthode SetMaxIdleConns(), comme indiqué ci-dessous : 🎜

// 初始化一个新的连接池
db, err := sql.Open("postgres", "postgres://user:pass@localhost/db")
if err != nil {
    log.Fatal(err)
}

// 将连接的最大生存期设置为1小时。将其设置为0意味着没有最大生存期，连接将永远可重用(这是默认行为)
db.SetConnMaxLifetime(time.Hour)

🎜 En théorie, autoriser davantage de connexions inactives dans le pool améliorera les performances, car il sera moins susceptible de repartir de zéro. de nouvelles connexions - contribuant ainsi à améliorer les performances de la base de données. 🎜🎜Jetons un coup d'œil au même benchmark avec le nombre maximum de connexions inactives défini sur aucun, 1, 2, 5 et 10 : 🎜🎜🎜BenchmarkMaxIdleConnsNone-8 300 4567245 ns/op 58174 B/op 625 allocs/op 🎜BenchmarkMaxIdleConns1-8 2000 568765 ns/op 2596 B/op 32 allocs/op🎜BenchmarkMaxIdleConns2-8 2000 529359 ns/op 596 B/op 11 allocs/op🎜BenchmarkMaxIdleConns5-8 2000 506207 ns/op 451 B/op 9 allocs/op🎜Be nchmarkMaxIdleConns10-8 2000 501639 ns/op 450 B/op 9 allocs/op🎜PASS🎜

当MaxIdleConns设置为none时，必须为每个INSERT从头创建一个新的连接，我们可以从基准测试中看到，平均运行时和内存使用量相对较高。

只允许保留和重用一个空闲连接对基准测试影响特别明显——它将平均运行时间减少了大约8倍，内存使用量减少了大约20倍。继续增加空闲连接池的大小会使性能变得更好，尽管改进并不明显。

那么，您应该维护一个大的空闲连接池吗?答案取决于应用程序。重要的是要意识到保持空闲连接是有代价的—它占用了可以用于应用程序和数据库的内存。

还有一种可能是，如果一个连接空闲时间太长，那么它可能会变得不可用。例如，MySQL的wait_timeout设置将自动关闭任何8小时(默认)内未使用的连接。

当发生这种情况时，sql.DB会优雅地处理它。坏连接将自动重试两次，然后放弃，此时Go将该连接从连接池中删除，并创建一个新的连接。因此，将MaxIdleConns设置得太大可能会导致连接变得不可用，与空闲连接池更小(使用更频繁的连接更少)相比，会占有更多的资源。所以，如果你很可能很快就会再次使用，你只需保持一个空闲的连接。

最后要指出的是，MaxIdleConns应该总是小于或等于MaxOpenConns.
。Go强制执行此操作，并在必要时自动减少MaxIdleConns。

SetConnMaxLifetime方法
现在让我们看看SetConnMaxLifetime()方法，它设置连接可重用的最大时间长度。如果您的SQL数据库也实现了最大连接生命周期，或者—例如—您希望方便地在负载均衡器后交换数据库，那么这将非常有用。
你可以这样使用它:

// 初始化一个新的连接池
db, err := sql.Open("postgres", "postgres://user:pass@localhost/db")
if err != nil {
    log.Fatal(err)
}

// 将连接的最大生存期设置为1小时。将其设置为0意味着没有最大生存期，连接将永远可重用(这是默认行为)
db.SetConnMaxLifetime(time.Hour)

在这个例子中，所有的连接都将在创建后1小时“过期”，并且在过期后无法重用。但注意:

• 这并不能保证连接将在池中存在整整一个小时；很有可能，由于某些原因，连接变得不可用，并在此之前自动关闭。
• 一个连接在创建后一个多小时仍然可以被使用——它只是在这个时间之后不能被重用。
• 这不是空闲超时。连接将在第一次创建后1小时过期——而不是在最后一次空闲后1小时。
• 每隔一秒自动运行一次清理操作，从连接池中删除“过期”的连接。

从理论上讲，ConnMaxLifetime越短，连接过期的频率就越高——因此，需要从头创建连接的频率就越高。为了说明这一点，我运行了将ConnMaxLifetime设置为100ms、200ms、500ms、1000ms和无限(永远重用)的基准测试，默认设置为无限打开连接和2个空闲连接。

这些时间段显然比您在大多数应用程序中使用的时间要短得多，但它们有助于很好地说明行为。

BenchmarkConnMaxLifetime100-8               2000        637902 ns/op        2770 B/op         34 allocs/op
BenchmarkConnMaxLifetime200-8               2000        576053 ns/op        1612 B/op         21 allocs/op
BenchmarkConnMaxLifetime500-8               2000        558297 ns/op         913 B/op         14 allocs/op
BenchmarkConnMaxLifetime1000-8              2000        543601 ns/op         740 B/op         12 allocs/op
BenchmarkConnMaxLifetimeUnlimited-8         3000        532789 ns/op         412 B/op          9 allocs/op
PASS

在这些特定的基准测试中，我们可以看到，与无限生存期相比，在100ms生存期时内存使用量增加了3倍以上，而且每个INSERT的平均运行时也稍微长一些。

如果您在代码中设置了ConnMaxLifetime，那么一定要记住连接将过期(随后重新创建)的频率。例如，如果您总共有100个连接，而ConnMaxLifetime为1分钟，那么您的应用程序可能每秒钟杀死和重新创建1.67个连接(平均值)。您不希望这个频率太大，最终会阻碍性能，而不是提高性能。

连接数量超出
最后，如果不说明超过数据库连接数量的硬限制将会发生什么，那么本文就不完整了。 为了说明这一点，我将修改postgresql.conf文件，这样总共只允许5个连接(默认是100个)…

max_connections = 5

然后在无限连接的情况下重新运行基准测试……

BenchmarkMaxOpenConnsUnlimited-8    — FAIL: BenchmarkMaxOpenConnsUnlimited-8
   main_test.go: 14: pq: sorry, too many clients already
   main_test.go: 14: pq: sorry, too many clients already
   main_test.go: 14: pq: sorry, too many clients already
FAIL

一旦达到5个连接的硬限制，数据库驱动程序(pq)立即返回一个太多客户端连接的错误消息，而无法完成INSERT。为了防止这个错误，我们需要将sql.DB中打开连接的最大总数(正在使用的+空闲的)设置为低于5。像这样:

// 初始化一个新的连接池
db, err := sql.Open("postgres", "postgres://user:pass@localhost/db")
if err != nil {
    log.Fatal(err)}
    // 将打开的连接数(正在使用的连接+空闲的连接)设置为最大总数3。
 db.SetMaxOpenConns (3)

现在，sql.DB在任何时候最多只能创建3个连接，基准测试运行时应该不会出现任何错误。但是这样做需要注意：当达到开放连接数限制，并且所有连接都在使用时，应用程序需要执行的任何新的数据库任务都将被迫等待，直到连接标记为空闲。例如，在web应用程序的上下文中，用户的HTTP请求看起来会“挂起”，甚至在等待数据库任务运行时可能会超时。

为了减轻这种情况，你应该始终在一个上下文中传递。在调用数据库时，启用上下文的方法(如ExecContext())，使用固定的、快速的超时上下文对象。

 
总结
1、根据经验，应该显式设置MaxOpenConns值。这应该小于数据库和基础设施对连接数量的硬性限制。
2、一般来说，更高的MaxOpenConns和MaxIdleConns值将带来更好的性能。但你应该注意到效果是递减的，连接池空闲连接太多(连接没有被重用，最终会变坏)实际上会导致性能下降。
3、为了降低上面第2点带来的风险，您可能需要设置一个相对较短的ConnMaxLifetime。但你也不希望它太短，导致连接被杀死或不必要地频繁重建。
4、MaxIdleConns应该总是小于或等于MaxOpenConns。
对于中小型web应用程序，我通常使用以下设置作为起点，然后根据实际吞吐量水平的负载测试结果进行优化。

db.SetMaxOpenConns(25)db.SetMaxIdleConns(25)db.SetConnMaxLifetime(5*time.Minute)

到此这篇关于golang配制高性能sql.DB的使用的文章就介绍到这了                                                     

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!