Neo4j Graph Database Fundamentals · レッスン

コネクションプールとエラー処理

Neo4jドライバーのコネクションプールを効率的に管理し、Neo4jをアプリケーションに統合する際のエラーとリトライを処理する方法を学びます。

「コネクションプールとエラー処理」はCoddyKit上の無料Neo4j Graph Database Fundamentalsレッスンです。これはレッスン4/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはNeo4j Graph Database Fundamentals学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Neo4j Graph Database Fundamentalsコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

The Driver Is Long-Lived

A common mistake is creating a new driver per request. The Neo4j driver manages a connection pool and should be created once and reused for your app's lifetime.

from neo4j import GraphDatabase

driver = GraphDatabase.driver('neo4j://localhost:7687', auth=('neo4j', 'password'))
# reuse driver everywhere; close at shutdown

What a Connection Pool Does

The driver keeps a pool of open connections and hands them out to sessions on demand. This avoids the cost of opening a TCP connection per query.

Tuning Pool Size

You can configure the maximum pool size and connection lifetime to match your workload.

driver = GraphDatabase.driver(
    uri,
    auth=auth,
    max_connection_pool_size=50,
    max_connection_lifetime=3600
)

Sessions Are Cheap

Unlike drivers, sessions are lightweight. Open a session per unit of work and close it promptly, ideally with a context manager.

with driver.session() as session:
    result = session.run('MATCH (n) RETURN count(n) AS c')
    print(result.single()['c'])

Transient vs Permanent Errors

Neo4j errors are classified. Transient errors (like a leader switch in a cluster) can be safely retried. Permanent errors (like syntax errors) cannot.

Automatic Retries

Managed transaction functions automatically retry on transient errors, which is why they are the recommended way to run writes.

def add_person(tx, name):
    tx.run('CREATE (:Person {name: $name})', name=name)

with driver.session() as session:
    session.execute_write(add_person, 'Alice')

Catching Driver Exceptions

Wrap calls to handle failures gracefully and surface useful messages to your app.

from neo4j.exceptions import ServiceUnavailable, CypherSyntaxError

try:
    with driver.session() as s:
        s.run('MATCH (n) RETURN n')
except ServiceUnavailable:
    print('Database unreachable')
except CypherSyntaxError as e:
    print('Bad query:', e)

Timeouts

Set transaction timeouts so a slow query does not hold a connection forever, freeing the pool for other work.

with driver.session() as s:
    s.run('MATCH (n) RETURN n', timeout=5)

Closing Resources

Always close the driver on application shutdown to release pooled connections cleanly.

import atexit
atexit.register(driver.close)

Pool Exhaustion

If all connections are busy, new requests wait. Symptoms include rising latency. Fixes: close sessions promptly, raise pool size, or shorten slow queries.

Production Checklist

For robust integration:

One shared driver instance
Short-lived sessions
Managed transactions for retries
Timeouts and exception handling
Close driver on shutdown

Quick Check

Test your connection management knowledge.

Recap

You learned robust driver usage:

Reuse a single long-lived driver
Sessions are cheap; open and close per task
Managed transactions retry transient errors
Handle exceptions and set timeouts
Avoid pool exhaustion with prompt cleanup

よくある質問

「コネクションプールとエラー処理」レッスンは無料ですか？

はい。「コネクションプールとエラー処理」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Neo4j Graph Database Fundamentalsコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Neo4j Graph Database Fundamentalsコースには全4レッスンが含まれています。

「コネクションプールとエラー処理」で何を学びますか？

Neo4jドライバーのコネクションプールを効率的に管理し、Neo4jをアプリケーションに統合する際のエラーとリトライを処理する方法を学びます。ブラウザで直接実行するハンズオンコードでNeo4j Graph Database Fundamentalsを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Neo4j Graph Database Fundamentalsを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのNeo4j Graph Database Fundamentalsは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン4/4です。

「コネクションプールとエラー処理」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このNeo4j Graph Database Fundamentalsレッスンでコードを書いて実行できますか？

はい。すべてのNeo4j Graph Database Fundamentalsレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Neo4j Graph Database Fundamentalsに戻る