mirror of
https://github.com/psycopg/psycopg2.git
synced 2025-05-29 18:23:08 +03:00
Notice -> Note in the docs, and a handful of other typo fixed
This commit is contained in:
parent
37a9eb3615
commit
3e39b23835
|
@ -351,7 +351,7 @@ returned, the connection can be safely used:
|
||||||
>>> wait(aconn)
|
>>> wait(aconn)
|
||||||
>>> acurs = aconn.cursor()
|
>>> acurs = aconn.cursor()
|
||||||
|
|
||||||
Notice that there are a few other requirements to be met in order to have a
|
Note that there are a few other requirements to be met in order to have a
|
||||||
completely non-blocking connection attempt: see the libpq documentation for
|
completely non-blocking connection attempt: see the libpq documentation for
|
||||||
|PQconnectStart|_.
|
|PQconnectStart|_.
|
||||||
|
|
||||||
|
|
|
@ -579,7 +579,7 @@ from the database. See :ref:`unicode-handling` for details.
|
||||||
TIME
|
TIME
|
||||||
UNICODE
|
UNICODE
|
||||||
|
|
||||||
Typecasters for basic types. Notice that a few other ones (`~psycopg2.BINARY`,
|
Typecasters for basic types. Note that a few other ones (`~psycopg2.BINARY`,
|
||||||
`~psycopg2.DATETIME`, `~psycopg2.NUMBER`, `~psycopg2.ROWID`,
|
`~psycopg2.DATETIME`, `~psycopg2.NUMBER`, `~psycopg2.ROWID`,
|
||||||
`~psycopg2.STRING`) are exposed by the `psycopg2` module for |DBAPI|_
|
`~psycopg2.STRING`) are exposed by the `psycopg2` module for |DBAPI|_
|
||||||
compliance.
|
compliance.
|
||||||
|
|
|
@ -36,7 +36,7 @@ directly into the client application.
|
||||||
|
|
||||||
Close all the connections handled by the pool.
|
Close all the connections handled by the pool.
|
||||||
|
|
||||||
Notice that all the connections are closed, including ones
|
Note that all the connections are closed, including ones
|
||||||
eventually in use by the application.
|
eventually in use by the application.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -180,9 +180,9 @@ reliable. It is really the case to stress this point:
|
||||||
The correct way to pass variables in a SQL command is using the second
|
The correct way to pass variables in a SQL command is using the second
|
||||||
argument of the `~cursor.execute()` method::
|
argument of the `~cursor.execute()` method::
|
||||||
|
|
||||||
>>> SQL = "INSERT INTO authors (name) VALUES (%s);" # Notice: no quotes
|
>>> SQL = "INSERT INTO authors (name) VALUES (%s);" # Note: no quotes
|
||||||
>>> data = ("O'Reilly", )
|
>>> data = ("O'Reilly", )
|
||||||
>>> cur.execute(SQL, data) # Notice: no % operator
|
>>> cur.execute(SQL, data) # Note: no % operator
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
@ -473,7 +473,7 @@ to a `~psycopg2.tz.FixedOffsetTimezone` instance.
|
||||||
>>> cur.fetchone()[0].tzinfo
|
>>> cur.fetchone()[0].tzinfo
|
||||||
psycopg2.tz.FixedOffsetTimezone(offset=60, name=None)
|
psycopg2.tz.FixedOffsetTimezone(offset=60, name=None)
|
||||||
|
|
||||||
Notice that only time zones with an integer number of minutes are supported:
|
Note that only time zones with an integer number of minutes are supported:
|
||||||
this is a limitation of the Python `datetime` module. A few historical time
|
this is a limitation of the Python `datetime` module. A few historical time
|
||||||
zones had seconds in the UTC offset: these time zones will have the offset
|
zones had seconds in the UTC offset: these time zones will have the offset
|
||||||
rounded to the nearest minute, with an error of up to 30 seconds.
|
rounded to the nearest minute, with an error of up to 30 seconds.
|
||||||
|
@ -568,9 +568,9 @@ method and to read the data using `~cursor.fetchone()` and
|
||||||
`~cursor.fetchmany()` methods.
|
`~cursor.fetchmany()` methods.
|
||||||
|
|
||||||
Named cursors are also :ref:`iterable <cursor-iterable>` like regular cursors.
|
Named cursors are also :ref:`iterable <cursor-iterable>` like regular cursors.
|
||||||
Notice however that before Psycopg 2.4 iteration was performed fetching one
|
Note however that before Psycopg 2.4 iteration was performed fetching one
|
||||||
record at time from the backend, resulting in a large overhead. The attribute
|
record at time from the backend, resulting in a large overhead. The attribute
|
||||||
`~cursor.itersize` now controls how many records are now fetched at time
|
`~cursor.itersize` now controls how many records are fetched at time
|
||||||
during the iteration: the default value of 2000 allows to fetch about 100KB
|
during the iteration: the default value of 2000 allows to fetch about 100KB
|
||||||
per roundtrip assuming records of 10-20 columns of mixed number and strings;
|
per roundtrip assuming records of 10-20 columns of mixed number and strings;
|
||||||
you may decrease this value if you are dealing with huge records.
|
you may decrease this value if you are dealing with huge records.
|
||||||
|
@ -584,7 +584,7 @@ value for the `withhold` parameter to `~connection.cursor()` or by setting the
|
||||||
`~cursor.withhold` attribute to `!True` before calling `~cursor.execute()` on
|
`~cursor.withhold` attribute to `!True` before calling `~cursor.execute()` on
|
||||||
the cursor. It is extremely important to always `~cursor.close()` such cursors,
|
the cursor. It is extremely important to always `~cursor.close()` such cursors,
|
||||||
otherwise they will continue to hold server-side resources until the connection
|
otherwise they will continue to hold server-side resources until the connection
|
||||||
will be eventually be closed. Also note that while :sql:`WITH HOLD` cursors
|
will be eventually closed. Also note that while :sql:`WITH HOLD` cursors
|
||||||
lifetime extends well after `~connection.commit()`, calling
|
lifetime extends well after `~connection.commit()`, calling
|
||||||
`~connection.rollback()` will automatically close the cursor.
|
`~connection.rollback()` will automatically close the cursor.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user