diff --git a/dictionaries/library_sqlite3.txt b/dictionaries/library_sqlite3.txt new file mode 100644 index 0000000000..154c06a26d --- /dev/null +++ b/dictionaries/library_sqlite3.txt @@ -0,0 +1,11 @@ +prototipar +Configurarla +autorizador +desconexión +commit +collation +backend +sobrecoste +arraysize +rowid +datetime diff --git a/library/sqlite3.po b/library/sqlite3.po index 404ced10f7..d54ddec834 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -6,27 +6,29 @@ # Check https://github.com/PyCampES/python-docs-es/blob/3.8/TRANSLATORS to # get the list of volunteers # -#, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.8\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2020-05-05 12:54+0200\n" -"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" -"Last-Translator: FULL NAME \n" +"PO-Revision-Date: 2020-10-29 22:31-0500\n" "Language-Team: python-doc-es\n" "MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" +"Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.8.0\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"Last-Translator: German David Ramírez Figueroa \n" +"Language: es\n" +"X-Generator: Poedit 2.4.1\n" #: ../Doc/library/sqlite3.rst:2 msgid ":mod:`sqlite3` --- DB-API 2.0 interface for SQLite databases" -msgstr "" +msgstr ":mod:`sqlite3` --- DB-API 2.0 interfaz para bases de datos SQLite" #: ../Doc/library/sqlite3.rst:9 msgid "**Source code:** :source:`Lib/sqlite3/`" -msgstr "" +msgstr "**Código fuente:** :source:`Lib/sqlite3/`" #: ../Doc/library/sqlite3.rst:13 msgid "" @@ -37,6 +39,12 @@ msgid "" "application using SQLite and then port the code to a larger database such as " "PostgreSQL or Oracle." msgstr "" +"SQLite es una biblioteca de C que provee una base de datos ligera basada en " +"disco que no requiere un proceso de servidor separado y permite acceder a la " +"base de datos usando una variación no estándar del lenguaje de consulta SQL. " +"Algunas aplicaciones pueden usar SQLite para almacenamiento interno. También " +"es posible prototipar una aplicación usando SQLite y luego transferir el " +"código a una base de datos más grande como PostgreSQL u Oracle." #: ../Doc/library/sqlite3.rst:20 msgid "" @@ -44,6 +52,8 @@ msgid "" "interface compliant with the DB-API 2.0 specification described by :pep:" "`249`." msgstr "" +"El módulo sqlite3 fue escrito por *Gerhard Häring*. Provee una interfaz SQL " +"compatible con la especificación DB-API 2.0 descrita por :pep:`249`." #: ../Doc/library/sqlite3.rst:23 msgid "" @@ -51,23 +61,33 @@ msgid "" "represents the database. Here the data will be stored in the :file:`example." "db` file::" msgstr "" +"Para usar el módulo, primero se debe crear un objeto :class:`Connection` que " +"representa la base de datos. Aquí los datos serán almacenados en el archivo :" +"file:`example.db`:" #: ../Doc/library/sqlite3.rst:30 msgid "" "You can also supply the special name ``:memory:`` to create a database in " "RAM." msgstr "" +"También se puede agregar el nombre especial ``:memory:`` para crear una base " +"de datos en memoria RAM." #: ../Doc/library/sqlite3.rst:32 msgid "" "Once you have a :class:`Connection`, you can create a :class:`Cursor` " "object and call its :meth:`~Cursor.execute` method to perform SQL commands::" msgstr "" +"Una vez se tenga una :class:`Connection`, se puede crear un objeto :class:" +"`Cursor` y llamar su método :meth:`~Cursor.execute` para ejecutar comandos " +"SQL:" #: ../Doc/library/sqlite3.rst:51 msgid "" "The data you've saved is persistent and is available in subsequent sessions::" msgstr "" +"Los datos guardados son persistidos y están disponibles en sesiones " +"posteriores::" #: ../Doc/library/sqlite3.rst:57 msgid "" @@ -76,6 +96,11 @@ msgid "" "doing so is insecure; it makes your program vulnerable to an SQL injection " "attack (see https://xkcd.com/327/ for humorous example of what can go wrong)." msgstr "" +"Usualmente, las operaciones SQL necesitarán usar valores de variables de " +"Python. No se debe ensamblar la consulta usando operaciones de cadena de " +"Python porque hacerlo es inseguro; vuelve el programa vulnerable a ataques " +"de inyección SQL (ver este divertido ejemplo de lo que puede salir mal: " +"https://xkcd.com/327/ )" #: ../Doc/library/sqlite3.rst:62 #, python-format @@ -86,6 +111,11 @@ msgid "" "method. (Other database modules may use a different placeholder, such as ``" "%s`` or ``:1``.) For example::" msgstr "" +"En cambio, se usan los parámetros de sustitución DB-API. Colocar ``?`` como " +"un marcador de posición en el lugar donde se usara un valor, y luego se " +"provee una tupla de valores como segundo argumento del método del cursor :" +"meth:`~Cursor.execute` (otros módulos de bases de datos pueden usar un " +"marcado de posición diferente, como ``%s`` o ``:1``). Por ejemplo:" #: ../Doc/library/sqlite3.rst:84 msgid "" @@ -94,77 +124,95 @@ msgid "" "fetchone` method to retrieve a single matching row, or call :meth:`~Cursor." "fetchall` to get a list of the matching rows." msgstr "" +"Para obtener los datos luego de ejecutar una sentencia SELECT, se puede " +"tratar el cursor como un :term:`iterator`, llamar el método del cursor :meth:" +"`~Cursor.fetchone` para obtener un solo registro, o llamar :meth:`~Cursor." +"fetchall` para obtener una lista de todos los registros." #: ../Doc/library/sqlite3.rst:89 msgid "This example uses the iterator form::" -msgstr "" +msgstr "Este ejemplo usa la forma con el iterador::" #: ../Doc/library/sqlite3.rst:104 msgid "https://github.com/ghaering/pysqlite" -msgstr "" +msgstr "https://github.com/ghaering/pysqlite" #: ../Doc/library/sqlite3.rst:103 msgid "" "The pysqlite web page -- sqlite3 is developed externally under the name " "\"pysqlite\"." msgstr "" +"La página web *pysqlite* -- sqlite3 se desarrolla externamente bajo el " +"nombre de \"pysqlite\"." #: ../Doc/library/sqlite3.rst:108 msgid "https://www.sqlite.org" -msgstr "" +msgstr "https://www.sqlite.org" #: ../Doc/library/sqlite3.rst:107 msgid "" "The SQLite web page; the documentation describes the syntax and the " "available data types for the supported SQL dialect." msgstr "" +"La página web SQLite; la documentación describe la sintaxis y los tipos de " +"datos disponibles para el lenguaje SQL soportado." #: ../Doc/library/sqlite3.rst:111 msgid "https://www.w3schools.com/sql/" -msgstr "" +msgstr "https://www.w3schools.com/sql/" #: ../Doc/library/sqlite3.rst:111 msgid "Tutorial, reference and examples for learning SQL syntax." -msgstr "" +msgstr "Tutorial, referencia y ejemplos para aprender sintaxis SQL." #: ../Doc/library/sqlite3.rst:113 msgid ":pep:`249` - Database API Specification 2.0" -msgstr "" +msgstr ":pep:`249` - Especificación de la API 2.0 de base de datos" #: ../Doc/library/sqlite3.rst:114 msgid "PEP written by Marc-André Lemburg." -msgstr "" +msgstr "PEP escrito por Marc-André Lemburg." #: ../Doc/library/sqlite3.rst:120 msgid "Module functions and constants" -msgstr "" +msgstr "Funciones y constantes del módulo" #: ../Doc/library/sqlite3.rst:125 msgid "" "The version number of this module, as a string. This is not the version of " "the SQLite library." msgstr "" +"El número de versión de este módulo, como una cadena de caracteres. Este no " +"es la versión de la librería SQLite." #: ../Doc/library/sqlite3.rst:131 msgid "" "The version number of this module, as a tuple of integers. This is not the " "version of the SQLite library." msgstr "" +"El número de versión de este módulo, como una tupla de enteros. Este no es " +"la versión de la librería SQLite." #: ../Doc/library/sqlite3.rst:137 msgid "The version number of the run-time SQLite library, as a string." msgstr "" +"El número de versión de la librería SQLite en tiempo de ejecución, como una " +"cadena de caracteres." #: ../Doc/library/sqlite3.rst:142 msgid "" "The version number of the run-time SQLite library, as a tuple of integers." msgstr "" +"El número de versión de la librería SQLite en tiempo de ejecución, como una " +"tupla de enteros." #: ../Doc/library/sqlite3.rst:147 ../Doc/library/sqlite3.rst:160 msgid "" "This constant is meant to be used with the *detect_types* parameter of the :" "func:`connect` function." msgstr "" +"Esta constante se usa con el parámetro *detect_types* de la función :func:" +"`connect`." #: ../Doc/library/sqlite3.rst:150 msgid "" @@ -175,6 +223,12 @@ msgid "" "look into the converters dictionary and use the converter function " "registered for that type there." msgstr "" +"Configurarla hace que el módulo :mod:`sqlite3` analice el tipo declarado " +"para cada columna que retorna. Este convertirá la primera palabra del tipo " +"declarado, i. e. para *\"integer primary key\"*, será convertido a *\"integer" +"\"*, o para \"*number(10)*\" será convertido a \"*number*\". Entonces para " +"esa columna, revisará el diccionario de conversiones y usará la función de " +"conversión registrada para ese tipo." #: ../Doc/library/sqlite3.rst:163 msgid "" @@ -188,12 +242,25 @@ msgid "" "out everything until the first ``'['`` for the column name and strip the " "preceeding space: the column name would simply be \"Expiration date\"." msgstr "" +"Configurar esto hace que la interfaz de SQLite analice el nombre para cada " +"columna que retorna, buscara una cadena de caracteres [mytype], y decidirá " +"cual 'mytype' es el tipo de la columna. Tratará de encontrar una entrada " +"'mytype' en el diccionario de conversiones y luego usar la función de " +"conversión encontrada allí y retornar el valor. El nombre de la columna " +"encontrada en :attr:`Cursor.description` no incluye el tipo, en otras " +"palabras, si se usa algo como ``'as ''Expiration date [datetime]\"'`` en el " +"SQL, entonces analizará todo lo demás hasta el primer ``'['`` para el nombre " +"de la columna y eliminará el espacio anterior: el nombre de la columna " +"sería: \"Expiration date\"." #: ../Doc/library/sqlite3.rst:176 msgid "" "Opens a connection to the SQLite database file *database*. By default " "returns a :class:`Connection` object, unless a custom *factory* is given." msgstr "" +"Abre una conexión al archivo de base de datos SQLite *database*. Por defecto " +"retorna un objeto :class:`Connection`, a menos que se indique un *factory* " +"personalizado." #: ../Doc/library/sqlite3.rst:179 msgid "" @@ -202,6 +269,11 @@ msgid "" "opened. You can use ``\":memory:\"`` to open a database connection to a " "database that resides in RAM instead of on disk." msgstr "" +"*database* es un :term:`path-like object` indicando el nombre de ruta " +"(absoluta o relativa al directorio de trabajo actual) del archivo de base de " +"datos abierto. Se puede usar ``\":memory:\"`` para abrir una conexión de " +"base de datos a una base de datos que reside en memoria RAM en lugar que " +"disco." #: ../Doc/library/sqlite3.rst:184 msgid "" @@ -211,12 +283,19 @@ msgid "" "connection should wait for the lock to go away until raising an exception. " "The default for the timeout parameter is 5.0 (five seconds)." msgstr "" +"Cuando una base de datos es accedida por múltiples conexiones, y uno de los " +"procesos modifica la base de datos, la base de datos SQLite se bloquea hasta " +"que la transacción se confirme. El parámetro *timeout* especifica que tanto " +"debe esperar la conexión para que el bloqueo desaparezca antes de lanzar una " +"excepción. Por defecto el parámetro *timeout* es de 5.0 (cinco segundos)." #: ../Doc/library/sqlite3.rst:190 msgid "" "For the *isolation_level* parameter, please see the :attr:`~Connection." "isolation_level` property of :class:`Connection` objects." msgstr "" +"Para el parámetro *isolation_level*, por favor ver la propiedad :attr:" +"`~Connection.isolation_level` del objeto :class:`Connection`." #: ../Doc/library/sqlite3.rst:193 msgid "" @@ -226,6 +305,11 @@ msgid "" "the module-level :func:`register_converter` function allow you to easily do " "that." msgstr "" +"De forma nativa SQLite soporta solo los tipos *TEXT*, *INTEGER*,*REAL*," +"*BLOB* y *NULL*. Si se quiere usar otros tipos, debe soportarlos usted " +"mismo. El parámetro *detect_types* y el uso de **converters** personalizados " +"registrados con la función a nivel del módulo :func:`register_converter` " +"permite hacerlo fácilmente." #: ../Doc/library/sqlite3.rst:198 msgid "" @@ -233,6 +317,9 @@ msgid "" "to any combination of :const:`PARSE_DECLTYPES` and :const:`PARSE_COLNAMES` " "to turn type detection on." msgstr "" +"*detect_types* por defecto es 0 (por ejemplo *off*, no detección de tipo), " +"se puede configurar a cualquier combinación de :const:`PARSE_DECLTYPES` y :" +"const:`PARSE_COLNAMES` para encender la detección." #: ../Doc/library/sqlite3.rst:202 msgid "" @@ -242,6 +329,11 @@ msgid "" "threads with the same connection writing operations should be serialized by " "the user to avoid data corruption." msgstr "" +"Por defecto, *check_same_thread* es :const:`True` y únicamente el hilo " +"creado puede utilizar la conexión. Si se configura :const:`False`, la " +"conexión retornada podrá ser compartida con múltiples hilos. Cuando se " +"utilizan múltiples hilos con la misma conexión, las operaciones de escritura " +"deberán ser serializadas por el usuario para evitar corrupción de datos." #: ../Doc/library/sqlite3.rst:207 msgid "" @@ -250,10 +342,15 @@ msgid "" "and make :func:`connect` use your class instead by providing your class for " "the *factory* parameter." msgstr "" +"Por defecto el módulo :mod:`sqlite3` utiliza su propia clase :class:" +"`Connection` para la llamada de conexión. Sin embargo se puede crear una " +"subclase de :class:`Connection` y hacer que :func:`connect` use su clase en " +"lugar de proveer la suya en el parámetro *factory*." #: ../Doc/library/sqlite3.rst:212 msgid "Consult the section :ref:`sqlite3-types` of this manual for details." msgstr "" +"Consulte la sección :ref:`sqlite3-types` de este manual para más detalles." #: ../Doc/library/sqlite3.rst:214 msgid "" @@ -262,6 +359,11 @@ msgid "" "that are cached for the connection, you can set the *cached_statements* " "parameter. The currently implemented default is to cache 100 statements." msgstr "" +"El módulo :mod:`sqlite3` internamente usa cache de declaraciones para evitar " +"un análisis SQL costoso. Si se desea especificar el número de sentencias que " +"estarán en memoria caché para la conexión, se puede configurar el parámetro " +"*cached_statements*. Por defecto están configurado para 100 sentencias en " +"memoria caché." #: ../Doc/library/sqlite3.rst:219 msgid "" @@ -269,6 +371,9 @@ msgid "" "specify options. For example, to open a database in read-only mode you can " "use::" msgstr "" +"Si *uri* es verdadero, la *database* se interpreta como una *URI*. Esto " +"permite especificar opciones. Por ejemplo, para abrir la base de datos en " +"modo solo lectura puedes usar::" #: ../Doc/library/sqlite3.rst:225 msgid "" @@ -276,21 +381,28 @@ msgid "" "can be found in the `SQLite URI documentation `_." msgstr "" +"Más información sobre esta característica, incluyendo una lista de opciones " +"reconocidas, pueden encontrarse en `la documentación de SQLite URI `_." #: ../Doc/library/sqlite3.rst:229 msgid "" "Raises an :ref:`auditing event ` ``sqlite3.connect`` with argument " "``database``." msgstr "" +"Lanza un :ref:`evento de auditoría ` ``sqlite3.connect`` con " +"argumento ``database``." #: ../Doc/library/sqlite3.rst:230 msgid "Added the *uri* parameter." -msgstr "" +msgstr "Agregado el parámetro *uri*." #: ../Doc/library/sqlite3.rst:233 msgid "" "*database* can now also be a :term:`path-like object`, not only a string." msgstr "" +"*database* ahora también puede ser un :term:`path-like object`, no solo una " +"cadena de caracteres." #: ../Doc/library/sqlite3.rst:239 msgid "" @@ -301,6 +413,13 @@ msgid "" "and the name of the type in your query are matched in case-insensitive " "manner." msgstr "" +"Registra un invocable para convertir un *bytestring* de la base de datos en " +"un tipo Python personalizado. El invocable será invocado por todos los " +"valores de la base de datos que son del tipo *typename*. Conceder el " +"parámetro *detect_types* de la función :func:`connect` para el " +"funcionamiento de la detección de tipo. Se debe notar que *typename* y el " +"nombre del tipo en la consulta son comparados insensiblemente a mayúsculas y " +"minúsculas." #: ../Doc/library/sqlite3.rst:248 msgid "" @@ -309,6 +428,10 @@ msgid "" "parameter the Python value, and must return a value of the following types: " "int, float, str or bytes." msgstr "" +"Registra un invocable para convertir el tipo Python personalizado *type* a " +"uno de los tipos soportados por SQLite's. El invocable *callable* acepta un " +"único parámetro de valor Python, y debe retornar un valor de los siguientes " +"tipos: *int*, *float*, *str* or *bytes*." #: ../Doc/library/sqlite3.rst:256 msgid "" @@ -317,11 +440,17 @@ msgid "" "syntactically correct, only that there are no unclosed string literals and " "the statement is terminated by a semicolon." msgstr "" +"Retorna :const:`True` si la cadena *sql* contiene una o más sentencias SQL " +"completas terminadas con punto y coma. No se verifica que la sentencia SQL " +"sea sintácticamente correcta, solo que no existan literales de cadenas no " +"cerradas y que la sentencia termine por un punto y coma." #: ../Doc/library/sqlite3.rst:261 msgid "" "This can be used to build a shell for SQLite, as in the following example:" msgstr "" +"Esto puede ser usado para construir un *shell* para SQLite, como en el " +"siguiente ejemplo:" #: ../Doc/library/sqlite3.rst:269 msgid "" @@ -331,14 +460,20 @@ msgid "" "get tracebacks from callbacks on ``sys.stderr``. Use :const:`False` to " "disable the feature again." msgstr "" +"Por defecto no se obtendrá ningún *tracebacks* en funciones definidas por el " +"usuario, agregaciones, *converters*, autorizador de *callbacks* etc. si se " +"quiere depurarlas, se puede llamar esta función con *flag* configurado a " +"``True``. Después se obtendrán *tracebacks* de los *callbacks* en ``sys." +"stderr``. Usar :const:`False` para deshabilitar la característica de nuevo." #: ../Doc/library/sqlite3.rst:279 msgid "Connection Objects" -msgstr "" +msgstr "Objetos de conexión" #: ../Doc/library/sqlite3.rst:283 msgid "A SQLite database connection has the following attributes and methods:" msgstr "" +"Una conexión a base de datos SQLite tiene los siguientes atributos y métodos:" #: ../Doc/library/sqlite3.rst:287 msgid "" @@ -346,12 +481,19 @@ msgid "" "mode or one of \"DEFERRED\", \"IMMEDIATE\" or \"EXCLUSIVE\". See section :" "ref:`sqlite3-controlling-transactions` for a more detailed explanation." msgstr "" +"Obtener o configurar el actual nivel de insolación. :const:`None` para modo " +"*autocommit* o uno de \"DEFERRED\", \"IMMEDIATE\" o \"EXCLUSIVO\". Ver " +"sección :ref:`sqlite3-controlling-transactions` para una explicación " +"detallada." #: ../Doc/library/sqlite3.rst:293 msgid "" ":const:`True` if a transaction is active (there are uncommitted changes), :" "const:`False` otherwise. Read-only attribute." msgstr "" +":const:`True` si una transacción está activa (existen cambios " +"*uncommitted*), :const:`False` en sentido contrario. Atributo de solo " +"lectura." #: ../Doc/library/sqlite3.rst:300 msgid "" @@ -359,6 +501,9 @@ msgid "" "supplied, this must be a callable returning an instance of :class:`Cursor` " "or its subclasses." msgstr "" +"El método cursor acepta un único parámetro opcional *factory*. Si es " +"agregado, éste debe ser un invocable que retorna una instancia de :class:" +"`Cursor` o sus subclases." #: ../Doc/library/sqlite3.rst:306 msgid "" @@ -367,12 +512,19 @@ msgid "" "other database connections. If you wonder why you don't see the data you've " "written to the database, please check you didn't forget to call this method." msgstr "" +"Este método asigna la transacción actual. Si no se llama este método, " +"cualquier cosa hecha desde la última llamada de ``commit()`` no es visible " +"para otras conexiones de bases de datos. Si se pregunta el porqué no se ven " +"los datos que escribiste, por favor verifica que no olvidaste llamar este " +"método." #: ../Doc/library/sqlite3.rst:313 msgid "" "This method rolls back any changes to the database since the last call to :" "meth:`commit`." msgstr "" +"Este método retrocede cualquier cambio en la base de datos desde la llamada " +"del último :meth:`commit`." #: ../Doc/library/sqlite3.rst:318 msgid "" @@ -380,6 +532,9 @@ msgid "" "call :meth:`commit`. If you just close your database connection without " "calling :meth:`commit` first, your changes will be lost!" msgstr "" +"Este método cierra la conexión a la base de datos. Nótese que éste no llama " +"automáticamente :meth:`commit`. Si se cierra la conexión a la base de datos " +"sin llamar primero :meth:`commit`, los cambios se perderán!" #: ../Doc/library/sqlite3.rst:324 msgid "" @@ -387,6 +542,9 @@ msgid "" "meth:`~Connection.cursor` method, calls the cursor's :meth:`~Cursor.execute` " "method with the *parameters* given, and returns the cursor." msgstr "" +"Este es un atajo no estándar que crea un objeto cursor llamando el método :" +"meth:`~Connection.cursor`, llama su método :meth:`~Cursor.execute` con los " +"*parameters* dados, y retorna el cursor." #: ../Doc/library/sqlite3.rst:331 msgid "" @@ -394,6 +552,9 @@ msgid "" "meth:`~Connection.cursor` method, calls the cursor's :meth:`~Cursor." "executemany` method with the *parameters* given, and returns the cursor." msgstr "" +"Este es un atajo no estándar que crea un objeto cursor llamando el método :" +"meth:`~Connection.cursor`, llama su método :meth:`~Cursor.executemany` con " +"los *parameters* dados, y retorna el cursor." #: ../Doc/library/sqlite3.rst:338 msgid "" @@ -401,6 +562,9 @@ msgid "" "meth:`~Connection.cursor` method, calls the cursor's :meth:`~Cursor." "executescript` method with the given *sql_script*, and returns the cursor." msgstr "" +"Este es un atajo no estándar que crea un objeto cursor llamando el método :" +"meth:`~Connection.cursor`, llama su método :meth:`~Cursor.executescript` con " +"el *sql_script*, y retorna el cursor." #: ../Doc/library/sqlite3.rst:345 msgid "" @@ -414,25 +578,36 @@ msgid "" "SQLite 3.8.3 or higher, :exc:`NotSupportedError` will be raised if used with " "older versions." msgstr "" +"Crea un función definida de usuario que se puede usar después desde " +"declaraciones SQL con el nombre de función *name*. *num_params* es el número " +"de parámetros que la función acepta (si *num_params* is -1, la función puede " +"tomar cualquier número de argumentos), y *func* es un invocable de Python " +"que es llamado como la función SQL. Si *deterministic* es verdadero, la " +"función creada es marcada como `deterministic `_, lo cual permite a SQLite hacer optimizaciones " +"adicionales. Esta marca es soportada por SQLite 3.8.3 o superior, será " +"lanzado :exc:`NotSupportedError` si se usa con versiones antiguas." #: ../Doc/library/sqlite3.rst:355 msgid "" "The function can return any of the types supported by SQLite: bytes, str, " "int, float and ``None``." msgstr "" +"La función puede retornar cualquier tipo soportado por SQLite: bytes, str, " +"int, float y ``None``." #: ../Doc/library/sqlite3.rst:358 msgid "The *deterministic* parameter was added." -msgstr "" +msgstr "El parámetro *deterministic* fue agregado." #: ../Doc/library/sqlite3.rst:361 ../Doc/library/sqlite3.rst:378 #: ../Doc/library/sqlite3.rst:492 ../Doc/library/sqlite3.rst:649 msgid "Example:" -msgstr "" +msgstr "Ejemplo:" #: ../Doc/library/sqlite3.rst:368 msgid "Creates a user-defined aggregate function." -msgstr "" +msgstr "Crea una función agregada definida por el usuario." #: ../Doc/library/sqlite3.rst:370 msgid "" @@ -441,12 +616,18 @@ msgid "" "take any number of arguments), and a ``finalize`` method which will return " "the final result of the aggregate." msgstr "" +"La clase agregada debe implementar un método ``step``, el cual acepta el " +"número de parámetros *num_params* (si *num_params* es -1, la función puede " +"tomar cualquier número de argumentos), y un método ``finalize`` el cual " +"retornará el resultado final del agregado." #: ../Doc/library/sqlite3.rst:375 msgid "" "The ``finalize`` method can return any of the types supported by SQLite: " "bytes, str, int, float and ``None``." msgstr "" +"El método ``finalize`` puede retornar cualquiera de los tipos soportados por " +"SQLite: bytes, str, int, float and ``None``." #: ../Doc/library/sqlite3.rst:385 msgid "" @@ -456,22 +637,34 @@ msgid "" "first is ordered higher than the second. Note that this controls sorting " "(ORDER BY in SQL) so your comparisons don't affect other SQL operations." msgstr "" +"Crea una collation con el *name* y *callable* especificado. El invocable " +"será pasado con dos cadenas de texto como argumentos. Se retornará -1 si el " +"primero esta ordenado menor que el segundo, 0 si están ordenados igual y 1 " +"si el primero está ordenado mayor que el segundo. Nótese que esto controla " +"la ordenación (ORDER BY en SQL) por lo tanto sus comparaciones no afectan " +"otras comparaciones SQL." #: ../Doc/library/sqlite3.rst:391 msgid "" "Note that the callable will get its parameters as Python bytestrings, which " "will normally be encoded in UTF-8." msgstr "" +"Note que el invocable obtiene sus parámetros como Python bytestrings, lo " +"cual normalmente será codificado en UTF-8." #: ../Doc/library/sqlite3.rst:394 msgid "" "The following example shows a custom collation that sorts \"the wrong way\":" msgstr "" +"El siguiente ejemplo muestra una *collation* personalizada que ordena \"La " +"forma incorrecta\":" #: ../Doc/library/sqlite3.rst:398 msgid "" "To remove a collation, call ``create_collation`` with ``None`` as callable::" msgstr "" +"Para remover una collation, llama ``create_collation`` con ``None`` como " +"invocable::" #: ../Doc/library/sqlite3.rst:405 msgid "" @@ -479,6 +672,9 @@ msgid "" "might be executing on the connection. The query will then abort and the " "caller will get an exception." msgstr "" +"Se puede llamar este método desde un hilo diferente para abortar cualquier " +"consulta que pueda estar ejecutándose en la conexión. La consulta será " +"abortada y quien realiza la llamada obtendrá una excepción." #: ../Doc/library/sqlite3.rst:412 msgid "" @@ -489,6 +685,12 @@ msgid "" "the column should be treated as a NULL value. These constants are available " "in the :mod:`sqlite3` module." msgstr "" +"Esta rutina registra un callback. El callback es invocado para cada intento " +"de acceso a un columna de una tabla en la base de datos. El callback deberá " +"retornar :const:`SQLITE_OK` si el acceso esta permitido, :const:" +"`SQLITE_DENY` si la completa declaración SQL deberá ser abortada con un " +"error y :const:`SQLITE_IGNORE` si la columna deberá ser tratada como un " +"valor NULL. Estas constantes están disponibles en el módulo :mod:`sqlite3`." #: ../Doc/library/sqlite3.rst:419 msgid "" @@ -500,6 +702,13 @@ msgid "" "attempt or :const:`None` if this access attempt is directly from input SQL " "code." msgstr "" +"El primer argumento del callback significa que tipo de operación será " +"autorizada. El segundo y tercer argumento serán argumentos o :const:`None` " +"dependiendo del primer argumento. El cuarto argumento es el nombre de la " +"base de datos (\"main\", \"temp\", etc.) si aplica. El quinto argumento es " +"el nombre del disparador más interno o vista que es responsable por los " +"intentos de acceso o :const:`None` si este intento de acceso es directo " +"desde el código SQL de entrada." #: ../Doc/library/sqlite3.rst:426 msgid "" @@ -508,6 +717,10 @@ msgid "" "the first one. All necessary constants are available in the :mod:`sqlite3` " "module." msgstr "" +"Por favor consulte la documentación de SQLite sobre los posibles valores " +"para el primer argumento y el significado del segundo y tercer argumento " +"dependiendo del primero. Todas las constantes necesarias están disponibles " +"en el módulo :mod:`sqlite3`." #: ../Doc/library/sqlite3.rst:433 msgid "" @@ -516,12 +729,18 @@ msgid "" "get called from SQLite during long-running operations, for example to update " "a GUI." msgstr "" +"Esta rutina registra un *callback*. El *callback* es invocado para cada *n* " +"instrucciones de la máquina virtual SQLite. Esto es útil si se quiere tener " +"llamado a SQLite durante operaciones de larga duración, por ejemplo para " +"actualizar una GUI." #: ../Doc/library/sqlite3.rst:438 msgid "" "If you want to clear any previously installed progress handler, call the " "method with :const:`None` for *handler*." msgstr "" +"Si se desea limpiar cualquier *progress handler* instalado previamente, " +"llame el método con :const:`None` para *handler*." #: ../Doc/library/sqlite3.rst:441 msgid "" @@ -529,12 +748,16 @@ msgid "" "currently executing query and cause it to raise an :exc:`OperationalError` " "exception." msgstr "" +"Retornando un valor diferente a 0 de la función gestora terminará la actual " +"consulta en ejecución y causará lanzar una excepción :exc:`OperationalError`." #: ../Doc/library/sqlite3.rst:448 msgid "" "Registers *trace_callback* to be called for each SQL statement that is " "actually executed by the SQLite backend." msgstr "" +"Registra *trace_callback* para ser llamado por cada sentencia SQL que " +"realmente se ejecute por el *backend* de SQLite." #: ../Doc/library/sqlite3.rst:451 msgid "" @@ -544,11 +767,19 @@ msgid "" "execute` methods. Other sources include the transaction management of the " "Python module and the execution of triggers defined in the current database." msgstr "" +"El único argumento pasado al callback es la sentencia (como cadena de texto) " +"que se está ejecutando. El valor retornado del *callback* es ignorado. " +"Nótese que el backend no solo ejecuta la sentencia pasada a los métodos :" +"meth:`Cursor.execute`. Otras fuentes incluyen el gestión de la transacción " +"del módulo de Python y la ejecución de los disparadores definidos en la " +"actual base de datos." #: ../Doc/library/sqlite3.rst:457 msgid "" "Passing :const:`None` as *trace_callback* will disable the trace callback." msgstr "" +"Pasando :const:`None` como *trace_callback* deshabilitara el *trace " +"callback*." #: ../Doc/library/sqlite3.rst:464 msgid "" @@ -557,10 +788,16 @@ msgid "" "aggregates or whole new virtual table implementations. One well-known " "extension is the fulltext-search extension distributed with SQLite." msgstr "" +"Esta rutina habilita/deshabilita el motor de SQLite para cargar extensiones " +"SQLite desde bibliotecas compartidas. Las extensiones SQLite pueden definir " +"nuevas funciones, agregaciones o una completa nueva implementación de tablas " +"virtuales. Una bien conocida extensión es *fulltext-search* distribuida con " +"SQLite." #: ../Doc/library/sqlite3.rst:469 ../Doc/library/sqlite3.rst:481 msgid "Loadable extensions are disabled by default. See [#f1]_." msgstr "" +"Las extensiones cargables están deshabilitadas por defecto. Ver [#f1]_." #: ../Doc/library/sqlite3.rst:477 msgid "" @@ -568,6 +805,9 @@ msgid "" "enable extension loading with :meth:`enable_load_extension` before you can " "use this routine." msgstr "" +"Esta rutina carga una extensión SQLite de una biblioteca compartida. Se debe " +"habilitar la carga de extensiones con :meth:`enable_load_extension` antes de " +"usar esta rutina." #: ../Doc/library/sqlite3.rst:487 msgid "" @@ -576,6 +816,11 @@ msgid "" "can implement more advanced ways of returning results, such as returning an " "object that can also access columns by name." msgstr "" +"Se puede cambiar este atributo a un invocable que acepta el cursor y la fila " +"original como una tupla y retornará la fila con el resultado real. De esta " +"forma, se puede implementar más avanzadas formas de retornar resultados, " +"tales como retornar un objeto que puede también acceder a las columnas por " +"su nombre." #: ../Doc/library/sqlite3.rst:496 msgid "" @@ -586,6 +831,13 @@ msgid "" "overhead. It will probably be better than your own custom dictionary-based " "approach or even a db_row based solution." msgstr "" +"Si retornado una tupla no es suficiente y se quiere acceder a las columnas " +"basadas en nombre, se debe considerar configurar :attr:`row_factory` a la " +"altamente optimizada tipo :class:`sqlite3.Row`. :class:`Row` provee ambos " +"accesos a columnas basada en índice y tipado insensible con casi nada de " +"sobrecoste de memoria. Será probablemente mejor que tú propio enfoque de " +"basado en diccionario personalizado o incluso mejor que una solución basada " +"en *db_row*." #: ../Doc/library/sqlite3.rst:508 msgid "" @@ -594,22 +846,32 @@ msgid "" "the :mod:`sqlite3` module will return Unicode objects for ``TEXT``. If you " "want to return bytestrings instead, you can set it to :class:`bytes`." msgstr "" +"Usando este atributo se puede controlar que objetos son retornados por el " +"tipo de dato ``TEXT``. Por defecto, este atributo es configurado a :class:" +"`str` y el módulo :mod:`sqlite3` retornará objetos Unicode para ``TEXT``. Si " +"en cambio se quiere retornar *bytestrings*, se debe configurar a :class:" +"`bytes`." #: ../Doc/library/sqlite3.rst:513 msgid "" "You can also set it to any other callable that accepts a single bytestring " "parameter and returns the resulting object." msgstr "" +"También se puede configurar a cualquier otro *callable* que acepte un único " +"parámetro *bytestring* y retorne el objeto resultante." #: ../Doc/library/sqlite3.rst:516 msgid "See the following example code for illustration:" -msgstr "" +msgstr "Ver el siguiente ejemplo de código para ilustración:" #: ../Doc/library/sqlite3.rst:523 msgid "" "Returns the total number of database rows that have been modified, inserted, " "or deleted since the database connection was opened." msgstr "" +"Regresa el número total de filas de la base de datos que han sido " +"modificadas, insertadas o borradas desde que la conexión a la base de datos " +"fue abierta." #: ../Doc/library/sqlite3.rst:529 msgid "" @@ -618,10 +880,14 @@ msgid "" "the same capabilities as the :kbd:`.dump` command in the :program:`sqlite3` " "shell." msgstr "" +"Regresa un iterador para volcar la base de datos en un texto de formato SQL. " +"Es útil cuando guardamos una base de datos en memoria para posterior " +"restauración. Esta función provee las mismas capacidades que el comando :kbd:" +"`dump` en el *shell* :program:`sqlite3`." #: ../Doc/library/sqlite3.rst:534 msgid "Example::" -msgstr "" +msgstr "Ejemplo::" #: ../Doc/library/sqlite3.rst:548 msgid "" @@ -630,6 +896,10 @@ msgid "" "will be written into the mandatory argument *target*, that must be another :" "class:`Connection` instance." msgstr "" +"Este método crea un respaldo de una base de datos SQLite incluso mientras " +"está siendo accedida por otros clientes, o concurrente por la misma " +"conexión. La copia será escrita dentro del argumento obligatorio *target*, " +"que deberá ser otra instancia de :class:`Connection`." #: ../Doc/library/sqlite3.rst:553 msgid "" @@ -637,6 +907,9 @@ msgid "" "entire database is copied in a single step; otherwise the method performs a " "loop copying up to *pages* pages at a time." msgstr "" +"Por defecto, o cuando *pages* es ``0`` o un entero negativo, la base de " +"datos completa es copiada en un solo paso; de otra forma el método realiza " +"un bucle copiando hasta el número de *pages* a la vez." #: ../Doc/library/sqlite3.rst:557 msgid "" @@ -645,6 +918,11 @@ msgid "" "respectively the *status* of the last iteration, the *remaining* number of " "pages still to be copied and the *total* number of pages." msgstr "" +"Si *progress* es especificado, deberá ser ``None`` o un objeto *callable* " +"que será ejecutado en cada iteración con los tres argumentos enteros, " +"respectivamente el estado *status* de la última iteración, el restante " +"*remaining* numero de páginas presentes para ser copiadas y el número total " +"*total* de páginas." #: ../Doc/library/sqlite3.rst:562 msgid "" @@ -654,6 +932,11 @@ msgid "" "specified after the ``AS`` keyword in an ``ATTACH DATABASE`` statement for " "an attached database." msgstr "" +"El argumento *name* especifica el nombre de la base de datos que será " +"copiada: deberá ser una cadena de texto que contenga el por defecto ``\"main" +"\"``, que indica la base de datos principal, ``\"temp\"`` que indica la base " +"de datos temporal o el nombre especificado después de la palabra clave " +"``AS`` en una sentencia ``ATTACH DATABASE`` para una base de datos adjunta." #: ../Doc/library/sqlite3.rst:568 msgid "" @@ -661,26 +944,31 @@ msgid "" "successive attempts to backup remaining pages, can be specified either as an " "integer or a floating point value." msgstr "" +"El argumento *sleep* especifica el número de segundos a dormir entre " +"sucesivos intentos de respaldar páginas restantes, puede ser especificado " +"como un entero o un valor de punto flotante." #: ../Doc/library/sqlite3.rst:572 msgid "Example 1, copy an existing database into another::" -msgstr "" +msgstr "Ejemplo 1, copiar una base de datos existente en otra::" #: ../Doc/library/sqlite3.rst:586 msgid "Example 2, copy an existing database into a transient copy::" msgstr "" +"Ejemplo 2: copiar una base de datos existente en una copia transitoria::" #: ../Doc/library/sqlite3.rst:594 msgid "Availability: SQLite 3.6.11 or higher" -msgstr "" +msgstr "Disponibilidad: SQLite 3.6.11 o superior" #: ../Doc/library/sqlite3.rst:602 msgid "Cursor Objects" -msgstr "" +msgstr "Objetos Cursor" #: ../Doc/library/sqlite3.rst:606 msgid "A :class:`Cursor` instance has the following attributes and methods." msgstr "" +"Una instancia de :class:`Cursor` tiene los siguientes atributos y métodos." #: ../Doc/library/sqlite3.rst:613 msgid "" @@ -689,10 +977,14 @@ msgid "" "two kinds of placeholders: question marks (qmark style) and named " "placeholders (named style)." msgstr "" +"Ejecuta una sentencia SQL. La sentencia SQL puede estar parametrizada (es " +"decir marcadores en lugar de literales SQL). El módulo :mod:`sqlite3` " +"soporta dos tipos de marcadores: signos de interrogación (estilo qmark) y " +"marcadores nombrados (estilo nombrado)." #: ../Doc/library/sqlite3.rst:618 msgid "Here's an example of both styles:" -msgstr "" +msgstr "Acá esta un ejemplo con los dos estilos:" #: ../Doc/library/sqlite3.rst:622 msgid "" @@ -701,6 +993,10 @@ msgid "" "Use :meth:`executescript` if you want to execute multiple SQL statements " "with one call." msgstr "" +":meth:`execute` solo ejecutará una única sentencia SQL. Si se trata de " +"ejecutar más de una sentencia con el, lanzará un :exc:`.Warning`. Usar :meth:" +"`executescript` si se quiere ejecutar múltiples sentencias SQL con una " +"llamada." #: ../Doc/library/sqlite3.rst:630 msgid "" @@ -708,10 +1004,14 @@ msgid "" "the sequence *seq_of_parameters*. The :mod:`sqlite3` module also allows " "using an :term:`iterator` yielding parameters instead of a sequence." msgstr "" +"Ejecuta un comando SQL contra todas las secuencias de parámetros o mapeos " +"encontrados en la secuencia *seq_of_parameters*. El módulo :mod:`sqlite3` " +"también permite usar un :term:`iterator` produciendo parámetros en lugar de " +"una secuencia." #: ../Doc/library/sqlite3.rst:636 msgid "Here's a shorter example using a :term:`generator`:" -msgstr "" +msgstr "Acá un corto ejemplo usando un :term:`generator`:" #: ../Doc/library/sqlite3.rst:643 msgid "" @@ -719,22 +1019,30 @@ msgid "" "statements at once. It issues a ``COMMIT`` statement first, then executes " "the SQL script it gets as a parameter." msgstr "" +"Este es un conveniente método no estándar para ejecutar múltiples sentencias " +"SQL de una vez. Emite una sentencia ``COMMIT`` primero, luego ejecuta el " +"script SQL obtenido como parámetro." #: ../Doc/library/sqlite3.rst:647 msgid "*sql_script* can be an instance of :class:`str`." -msgstr "" +msgstr "*sql_script* puede ser una instancia de :class:`str`." #: ../Doc/library/sqlite3.rst:656 msgid "" "Fetches the next row of a query result set, returning a single sequence, or :" "const:`None` when no more data is available." msgstr "" +"Obtiene la siguiente fila de un conjunto resultado, retorna una única " +"secuencia, o :const:`None` cuando no hay más datos disponibles." #: ../Doc/library/sqlite3.rst:662 msgid "" "Fetches the next set of rows of a query result, returning a list. An empty " "list is returned when no more rows are available." msgstr "" +"Obtiene el siguiente conjunto de filas del resultado de una consulta, " +"retornando una lista. Una lista vacía es retornada cuando no hay más filas " +"disponibles." #: ../Doc/library/sqlite3.rst:665 msgid "" @@ -744,6 +1052,12 @@ msgid "" "size parameter. If this is not possible due to the specified number of rows " "not being available, fewer rows may be returned." msgstr "" +"El número de filas a obtener por llamado es especificado por el parámetro " +"*size*. Si no es suministrado, el arraysize del cursor determina el número " +"de filas a obtener. El método debería intentar obtener tantas filas como las " +"indicadas por el parámetro size. Si esto no es posible debido a que el " +"número especificado de filas no está disponible, entonces menos filas " +"deberán ser retornadas." #: ../Doc/library/sqlite3.rst:671 msgid "" @@ -752,6 +1066,10 @@ msgid "" "attribute. If the *size* parameter is used, then it is best for it to retain " "the same value from one :meth:`fetchmany` call to the next." msgstr "" +"Nótese que hay consideraciones de desempeño involucradas con el parámetro " +"*size*. Para un optimo desempeño, es usualmente mejor usar el atributo " +"*arraysize*. Si el parámetro *size* es usado, entonces es mejor retener el " +"mismo valor de una llamada :meth:`fetchmany` a la siguiente." #: ../Doc/library/sqlite3.rst:678 msgid "" @@ -759,10 +1077,13 @@ msgid "" "the cursor's arraysize attribute can affect the performance of this " "operation. An empty list is returned when no rows are available." msgstr "" +"Obtiene todas las filas (restantes) del resultado de una consulta. Nótese " +"que el atributo arraysize del cursor puede afectar el desempeño de esta " +"operación. Una lista vacía será retornada cuando no hay filas disponibles." #: ../Doc/library/sqlite3.rst:684 msgid "Close the cursor now (rather than whenever ``__del__`` is called)." -msgstr "" +msgstr "Cierra el cursor ahora (en lugar que cuando ``__del__`` es llamado)" #: ../Doc/library/sqlite3.rst:686 msgid "" @@ -770,6 +1091,9 @@ msgid "" "`ProgrammingError` exception will be raised if any operation is attempted " "with the cursor." msgstr "" +"El cursor no será usable de este punto en adelante; una excepción :exc:" +"`ProgrammingError` será lanzada si se intenta cualquier operación con el " +"cursor." #: ../Doc/library/sqlite3.rst:691 msgid "" @@ -777,12 +1101,17 @@ msgid "" "this attribute, the database engine's own support for the determination of " "\"rows affected\"/\"rows selected\" is quirky." msgstr "" +"A pesar de que la clase :class:`Cursor` del módulo :mod:`sqlite3` implementa " +"este atributo, el propio soporte del motor de base de datos para la " +"determinación de \"filas afectadas\"/\"filas seleccionadas\" es raro." #: ../Doc/library/sqlite3.rst:695 msgid "" "For :meth:`executemany` statements, the number of modifications are summed " "up into :attr:`rowcount`." msgstr "" +"Para sentencias :meth:`executemany`, el número de modificaciones se resumen " +"en :attr:`rowcount`." #: ../Doc/library/sqlite3.rst:698 msgid "" @@ -792,12 +1121,20 @@ msgid "" "includes ``SELECT`` statements because we cannot determine the number of " "rows a query produced until all rows were fetched." msgstr "" +"Cómo lo requiere la especificación Python DB API, el atributo :attr:" +"`rowcount` \"es -1 en caso de que ``executeXX()`` no haya sido ejecutada en " +"el cursor o en el *rowcount* de la última operación no haya sido determinada " +"por la interface\". Esto incluye sentencias ``SELECT`` porque no podemos " +"determinar el número de filas que una consulta produce hasta que todas las " +"filas sean obtenidas." #: ../Doc/library/sqlite3.rst:704 msgid "" "With SQLite versions before 3.6.5, :attr:`rowcount` is set to 0 if you make " "a ``DELETE FROM table`` without any condition." msgstr "" +"Con versiones de SQLite anteriores a 3.6.5, :attr:`rowcount` es configurado " +"a 0 si se hace un ``DELETE FROM table`` sin ninguna condición." #: ../Doc/library/sqlite3.rst:709 msgid "" @@ -807,16 +1144,23 @@ msgid "" "or when :meth:`executemany` is called, :attr:`lastrowid` is set to :const:" "`None`." msgstr "" +"Este atributo de solo lectura provee el rowid de la última fila modificada. " +"Solo se configura si se emite una sentencia ``INSERT`` o ``REPLACE`` usando " +"el método :meth:`execute`. Para otras operaciones diferentes a ``INSERT`` o " +"``REPLACE`` o cuando :meth:`executemany` es llamado, :attr:`lastrowid` es " +"configurado a :const:`None`." #: ../Doc/library/sqlite3.rst:715 msgid "" "If the ``INSERT`` or ``REPLACE`` statement failed to insert the previous " "successful rowid is returned." msgstr "" +"Si la sentencia ``INSERT`` o ``REPLACE`` no se pudo insertar, se retorna el " +"anterior rowid exitoso." #: ../Doc/library/sqlite3.rst:718 msgid "Added support for the ``REPLACE`` statement." -msgstr "" +msgstr "Se agregó soporte para sentencias ``REPLACE``." #: ../Doc/library/sqlite3.rst:723 msgid "" @@ -824,6 +1168,9 @@ msgid "" "`fetchmany`. The default value is 1 which means a single row would be " "fetched per call." msgstr "" +"Atributo de lectura/escritura que controla el número de filas retornadas " +"por :meth:`fetchmany`. El valor por defecto es 1, lo cual significa que una " +"única fila será obtenida por llamada." #: ../Doc/library/sqlite3.rst:728 msgid "" @@ -831,10 +1178,15 @@ msgid "" "remain compatible with the Python DB API, it returns a 7-tuple for each " "column where the last six items of each tuple are :const:`None`." msgstr "" +"Este atributo de solo lectura provee el nombre de las columnas de la última " +"consulta. Para ser compatible con Python DB API, retorna una 7-tupla para " +"cada columna en donde los últimos seis ítems de cada tupla son :const:`None`." #: ../Doc/library/sqlite3.rst:732 msgid "It is set for ``SELECT`` statements without any matching rows as well." msgstr "" +"También es configurado para sentencias ``SELECT`` sin ninguna fila " +"coincidente." #: ../Doc/library/sqlite3.rst:736 msgid "" @@ -843,10 +1195,14 @@ msgid "" "calling :meth:`con.cursor() ` will have a :attr:" "`connection` attribute that refers to *con*::" msgstr "" +"Este atributo de solo lectura provee la :class:`Connection` de la base de " +"datos SQLite usada por el objeto :class:`Cursor`. Un objeto :class:`Cursor` " +"creado por la llamada de :meth:`con.cursor() ` tendrá un " +"atributo :attr:`connection` que se refiere a *con*::" #: ../Doc/library/sqlite3.rst:749 msgid "Row Objects" -msgstr "" +msgstr "Objetos Fila (*Row*)" #: ../Doc/library/sqlite3.rst:753 msgid "" @@ -854,60 +1210,76 @@ msgid "" "row_factory` for :class:`Connection` objects. It tries to mimic a tuple in " "most of its features." msgstr "" +"Una instancia :class:`Row` sirve como una altamente optimizada :attr:" +"`~Connection.row_factory` para objetos :class:`Connection`. Esta trata de " +"imitar una tupla en su mayoría de características." #: ../Doc/library/sqlite3.rst:757 msgid "" "It supports mapping access by column name and index, iteration, " "representation, equality testing and :func:`len`." msgstr "" +"Soporta acceso mapeado por nombre de columna e índice, iteración, " +"representación, pruebas de igualdad y :func:`len`." #: ../Doc/library/sqlite3.rst:760 msgid "" "If two :class:`Row` objects have exactly the same columns and their members " "are equal, they compare equal." msgstr "" +"Si dos objetos :class:`Row` tienen exactamente las mismas columnas y sus " +"miembros son iguales, entonces se comparan a igual." #: ../Doc/library/sqlite3.rst:765 msgid "" "This method returns a list of column names. Immediately after a query, it is " "the first member of each tuple in :attr:`Cursor.description`." msgstr "" +"Este método retorna una lista con los nombre de columnas. Inmediatamente " +"después de una consulta, es el primer miembro de cada tupla en :attr:`Cursor." +"description`." #: ../Doc/library/sqlite3.rst:768 msgid "Added support of slicing." -msgstr "" +msgstr "Agrega soporte de segmentación." #: ../Doc/library/sqlite3.rst:771 msgid "Let's assume we initialize a table as in the example given above::" -msgstr "" +msgstr "Vamos a asumir que se inicializa una tabla como en el ejemplo dado::" #: ../Doc/library/sqlite3.rst:783 msgid "Now we plug :class:`Row` in::" -msgstr "" +msgstr "Ahora conectamos :class:`Row` en::" #: ../Doc/library/sqlite3.rst:815 msgid "Exceptions" -msgstr "" +msgstr "Excepciones" #: ../Doc/library/sqlite3.rst:819 msgid "A subclass of :exc:`Exception`." -msgstr "" +msgstr "Una subclase de :exc:`Exception`." #: ../Doc/library/sqlite3.rst:823 msgid "" "The base class of the other exceptions in this module. It is a subclass of :" "exc:`Exception`." msgstr "" +"La clase base de otras excepciones en este módulo. Es una subclase de :exc:" +"`Exception`." #: ../Doc/library/sqlite3.rst:828 msgid "Exception raised for errors that are related to the database." msgstr "" +"Excepción lanzada para errores que están relacionados con la base de datos." #: ../Doc/library/sqlite3.rst:832 msgid "" "Exception raised when the relational integrity of the database is affected, " "e.g. a foreign key check fails. It is a subclass of :exc:`DatabaseError`." msgstr "" +"Excepción lanzada cuando la integridad de la base de datos es afectada, por " +"ejemplo la comprobación de una llave foránea falla. Es una subclase de :exc:" +"`DatabaseError`." #: ../Doc/library/sqlite3.rst:837 msgid "" @@ -915,6 +1287,9 @@ msgid "" "exists, syntax error in the SQL statement, wrong number of parameters " "specified, etc. It is a subclass of :exc:`DatabaseError`." msgstr "" +"Excepción lanzada por errores de programación, e.g. tabla no encontrada o ya " +"existente, error de sintaxis en la sentencia SQL, número equivocado de " +"parámetros especificados, etc. Es una subclase de :exc:`DatabaseError`." #: ../Doc/library/sqlite3.rst:843 msgid "" @@ -923,6 +1298,11 @@ msgid "" "disconnect occurs, the data source name is not found, a transaction could " "not be processed, etc. It is a subclass of :exc:`DatabaseError`." msgstr "" +"Excepción lanzada por errores relacionados por la operación de la base de " +"datos y no necesariamente bajo el control del programador, por ejemplo " +"ocurre una desconexión inesperada, el nombre de la fuente de datos no es " +"encontrado, una transacción no pudo ser procesada, etc. Es una subclase de :" +"exc:`DatabaseError`." #: ../Doc/library/sqlite3.rst:850 msgid "" @@ -931,81 +1311,90 @@ msgid "" "method on a connection that does not support transaction or has transactions " "turned off. It is a subclass of :exc:`DatabaseError`." msgstr "" +"Excepción lanzada en caso de que un método o API de base de datos fuera " +"usada en una base de datos que no la soporta, e.g. llamando el método :meth:" +"`~Connection.rollback` en una conexión que no soporta la transacción o tiene " +"deshabilitada las transacciones. Es una subclase de :exc:`DatabaseError`." #: ../Doc/library/sqlite3.rst:859 msgid "SQLite and Python types" -msgstr "" +msgstr "SQLite y tipos de Python" #: ../Doc/library/sqlite3.rst:863 msgid "Introduction" -msgstr "" +msgstr "Introducción" #: ../Doc/library/sqlite3.rst:865 msgid "" "SQLite natively supports the following types: ``NULL``, ``INTEGER``, " "``REAL``, ``TEXT``, ``BLOB``." msgstr "" +"SQLite soporta de forma nativa los siguientes tipos: ``NULL``, ``INTEGER``, " +"``REAL``, ``TEXT``, ``BLOB``." #: ../Doc/library/sqlite3.rst:868 msgid "" "The following Python types can thus be sent to SQLite without any problem:" msgstr "" +"Los siguientes tipos de Python se pueden enviar a SQLite sin problema alguno:" #: ../Doc/library/sqlite3.rst:871 ../Doc/library/sqlite3.rst:888 msgid "Python type" -msgstr "" +msgstr "Tipo de Python" #: ../Doc/library/sqlite3.rst:871 ../Doc/library/sqlite3.rst:888 msgid "SQLite type" -msgstr "" +msgstr "Tipo de SQLite" #: ../Doc/library/sqlite3.rst:873 ../Doc/library/sqlite3.rst:890 msgid ":const:`None`" -msgstr "" +msgstr ":const:`None`" #: ../Doc/library/sqlite3.rst:873 ../Doc/library/sqlite3.rst:890 msgid "``NULL``" -msgstr "" +msgstr "``NULL``" #: ../Doc/library/sqlite3.rst:875 ../Doc/library/sqlite3.rst:892 msgid ":class:`int`" -msgstr "" +msgstr ":class:`int`" #: ../Doc/library/sqlite3.rst:875 ../Doc/library/sqlite3.rst:892 msgid "``INTEGER``" -msgstr "" +msgstr "``INTEGER``" #: ../Doc/library/sqlite3.rst:877 ../Doc/library/sqlite3.rst:894 msgid ":class:`float`" -msgstr "" +msgstr ":class:`float`" #: ../Doc/library/sqlite3.rst:877 ../Doc/library/sqlite3.rst:894 msgid "``REAL``" -msgstr "" +msgstr "``REAL``" #: ../Doc/library/sqlite3.rst:879 msgid ":class:`str`" -msgstr "" +msgstr ":class:`str`" #: ../Doc/library/sqlite3.rst:879 ../Doc/library/sqlite3.rst:896 msgid "``TEXT``" -msgstr "" +msgstr "``TEXT``" #: ../Doc/library/sqlite3.rst:881 ../Doc/library/sqlite3.rst:899 msgid ":class:`bytes`" -msgstr "" +msgstr ":class:`bytes`" #: ../Doc/library/sqlite3.rst:881 ../Doc/library/sqlite3.rst:899 msgid "``BLOB``" -msgstr "" +msgstr "``BLOB``" #: ../Doc/library/sqlite3.rst:885 msgid "This is how SQLite types are converted to Python types by default:" msgstr "" +"De esta forma es como los tipos de SQLite son convertidos a tipos de Python " +"por defecto:" #: ../Doc/library/sqlite3.rst:896 msgid "depends on :attr:`~Connection.text_factory`, :class:`str` by default" -msgstr "" +msgstr "depende de :attr:`~Connection.text_factory`, :class:`str` por defecto" #: ../Doc/library/sqlite3.rst:902 msgid "" @@ -1014,10 +1403,16 @@ msgid "" "adaptation, and you can let the :mod:`sqlite3` module convert SQLite types " "to different Python types via converters." msgstr "" +"El sistema de tipos del módulo :mod:`sqlite3` es extensible en dos formas: " +"se puede almacenar tipos de Python adicionales en una base de datos SQLite " +"vía adaptación de objetos, y se puede permitir que el módulo :mod:`sqlite3` " +"convierta tipos SQLite a diferentes tipos de Python vía convertidores." #: ../Doc/library/sqlite3.rst:909 msgid "Using adapters to store additional Python types in SQLite databases" msgstr "" +"Usando adaptadores para almacenar tipos adicionales de Python en bases de " +"datos SQLite" #: ../Doc/library/sqlite3.rst:911 msgid "" @@ -1026,22 +1421,30 @@ msgid "" "sqlite3 module's supported types for SQLite: one of NoneType, int, float, " "str, bytes." msgstr "" +"Como se describió anteriormente, SQLite soporta solamente un conjunto " +"limitado de tipos de forma nativa. Para usar otros tipos de Python con " +"SQLite, se deben **adaptar** a uno de los tipos de datos soportados por el " +"módulo sqlite3 para SQLite: uno de NoneType, int, float, str, bytes. " #: ../Doc/library/sqlite3.rst:916 msgid "" "There are two ways to enable the :mod:`sqlite3` module to adapt a custom " "Python type to one of the supported ones." msgstr "" +"Hay dos formas de habilitar el módulo :mod:`sqlite3` para adaptar un tipo " +"personalizado de Python a alguno de los admitidos." #: ../Doc/library/sqlite3.rst:921 msgid "Letting your object adapt itself" -msgstr "" +msgstr "Permitiéndole al objeto auto adaptarse" #: ../Doc/library/sqlite3.rst:923 msgid "" "This is a good approach if you write the class yourself. Let's suppose you " "have a class like this::" msgstr "" +"Este es un buen enfoque si uno mismo escribe la clase. Vamos a suponer que " +"se tiene una clase como esta::" #: ../Doc/library/sqlite3.rst:930 msgid "" @@ -1052,10 +1455,16 @@ msgid "" "protocol)`` which must return the converted value. The parameter *protocol* " "will be :class:`PrepareProtocol`." msgstr "" +"Ahora se quiere almacenar el punto en una columna SQLite. Primero se debe " +"elegir un tipo de los soportados para representar el punto. Se va a usar " +"cadena de texto separando las coordenadas usando un punto y coma. Luego se " +"necesita proveer a la clase el método ``__conform__(self, protocol)`` el " +"cuál deberá retornar el valor convertido. El parámetro *protocol* será :" +"class:`PrepareProtocol`." #: ../Doc/library/sqlite3.rst:940 msgid "Registering an adapter callable" -msgstr "" +msgstr "Registrando un adaptador invocable" #: ../Doc/library/sqlite3.rst:942 msgid "" @@ -1063,6 +1472,9 @@ msgid "" "string representation and register the function with :meth:" "`register_adapter`." msgstr "" +"La otra posibilidad es crear una función que convierta el escrito a " +"representación de cadena de texto y registrar la función con :meth:" +"`register_adapter`." #: ../Doc/library/sqlite3.rst:947 msgid "" @@ -1071,10 +1483,15 @@ msgid "" "suppose we want to store :class:`datetime.datetime` objects not in ISO " "representation, but as a Unix timestamp." msgstr "" +"El módulo :mod:`sqlite3` tiene dos adaptadores por defecto para las " +"funciones integradas de Python :class:`datetime.date` y tipos :class:" +"`datetime.datetime`. Ahora vamos a suponer que queremos almacenar objetos :" +"class:`datetime.datetime` no en representación ISO, sino como una marca de " +"tiempo Unix." #: ../Doc/library/sqlite3.rst:956 msgid "Converting SQLite values to custom Python types" -msgstr "" +msgstr "Convertir valores SQLite a tipos de Python personalizados" #: ../Doc/library/sqlite3.rst:958 msgid "" @@ -1082,42 +1499,54 @@ msgid "" "it really useful we need to make the Python to SQLite to Python roundtrip " "work." msgstr "" +"Escribir un adaptador permite enviar escritos personalizados de Python a " +"SQLite. Pero para hacer esto realmente útil, tenemos que hace el flujo " +"Python a SQLite a Python." #: ../Doc/library/sqlite3.rst:961 msgid "Enter converters." -msgstr "" +msgstr "Ingresar convertidores." #: ../Doc/library/sqlite3.rst:963 msgid "" "Let's go back to the :class:`Point` class. We stored the x and y coordinates " "separated via semicolons as strings in SQLite." msgstr "" +"Regresemos a la clase :class:`Point`. Se almacena las coordenadas x e y de " +"forma separada por punto y coma como una cadena de texto en SQLite." #: ../Doc/library/sqlite3.rst:966 msgid "" "First, we'll define a converter function that accepts the string as a " "parameter and constructs a :class:`Point` object from it." msgstr "" +"Primero, se define una función de conversión que acepta la cadena de texto " +"como un parámetro y construye un objeto :class:`Point` de ahí." #: ../Doc/library/sqlite3.rst:971 msgid "" "Converter functions **always** get called with a :class:`bytes` object, no " "matter under which data type you sent the value to SQLite." msgstr "" +"Las funciones de conversión **siempre** son llamadas con un objeto :class:" +"`bytes`, no importa bajo qué tipo de dato se envió el valor a SQLite." #: ../Doc/library/sqlite3.rst:980 msgid "" "Now you need to make the :mod:`sqlite3` module know that what you select " "from the database is actually a point. There are two ways of doing this:" msgstr "" +"Ahora se necesita hacer que el módulo :mod:`sqlite3` conozca que lo que tu " +"seleccionaste de la base de datos es de hecho un punto. Hay dos formas de " +"hacer esto:" #: ../Doc/library/sqlite3.rst:983 msgid "Implicitly via the declared type" -msgstr "" +msgstr "Implícitamente vía el tipo declarado" #: ../Doc/library/sqlite3.rst:985 msgid "Explicitly via the column name" -msgstr "" +msgstr "Explícitamente vía el nombre de la columna" #: ../Doc/library/sqlite3.rst:987 msgid "" @@ -1125,20 +1554,25 @@ msgid "" "entries for the constants :const:`PARSE_DECLTYPES` and :const:" "`PARSE_COLNAMES`." msgstr "" +"Ambas formas están descritas en la sección :ref:`sqlite3-module-contents`, " +"en las entradas para las constantes :const:`PARSE_DECLTYPES` y :const:" +"`PARSE_COLNAMES`." #: ../Doc/library/sqlite3.rst:990 msgid "The following example illustrates both approaches." -msgstr "" +msgstr "El siguiente ejemplo ilustra ambos enfoques." #: ../Doc/library/sqlite3.rst:996 msgid "Default adapters and converters" -msgstr "" +msgstr "Adaptadores y convertidores por defecto" #: ../Doc/library/sqlite3.rst:998 msgid "" "There are default adapters for the date and datetime types in the datetime " "module. They will be sent as ISO dates/ISO timestamps to SQLite." msgstr "" +"Hay adaptadores por defecto para los tipos date y datetime en el módulo " +"datetime. Éstos serán enviados como fechas/marcas de tiempo ISO a SQLite." #: ../Doc/library/sqlite3.rst:1001 msgid "" @@ -1146,6 +1580,9 @@ msgid "" "`datetime.date` and under the name \"timestamp\" for :class:`datetime." "datetime`." msgstr "" +"Los convertidores por defecto están registrados bajo el nombre \"date\" " +"para :class:`datetime.date` y bajo el mismo nombre para \"timestamp\" para :" +"class:`datetime.datetime`." #: ../Doc/library/sqlite3.rst:1005 msgid "" @@ -1153,10 +1590,13 @@ msgid "" "fiddling in most cases. The format of the adapters is also compatible with " "the experimental SQLite date/time functions." msgstr "" +"De esta forma, se puede usar date/timestamps para Python sin ajuste " +"adicional en la mayoría de los casos. El formato de los adaptadores también " +"es compatible con las funciones experimentales de SQLite date/time." #: ../Doc/library/sqlite3.rst:1009 msgid "The following example demonstrates this." -msgstr "" +msgstr "El siguiente ejemplo demuestra esto." #: ../Doc/library/sqlite3.rst:1013 msgid "" @@ -1164,16 +1604,21 @@ msgid "" "its value will be truncated to microsecond precision by the timestamp " "converter." msgstr "" +"Si un *timestamp* almacenado en SQLite tiene una parte fraccional mayor a 6 " +"números, este valor será truncado a precisión de microsegundos por el " +"convertidor de *timestamp*." #: ../Doc/library/sqlite3.rst:1021 msgid "Controlling Transactions" -msgstr "" +msgstr "Controlando Transacciones" #: ../Doc/library/sqlite3.rst:1023 msgid "" "The underlying ``sqlite3`` library operates in ``autocommit`` mode by " "default, but the Python :mod:`sqlite3` module by default does not." msgstr "" +"La librería subyacente ``sqlite3`` opera en modo ``autocommit`` por defecto, " +"pero el módulo de Python :mod:`sqlite3` no." #: ../Doc/library/sqlite3.rst:1026 msgid "" @@ -1182,6 +1627,11 @@ msgid "" "``autocommit`` mode, and a ``COMMIT``, a ``ROLLBACK``, or a ``RELEASE`` that " "ends the outermost transaction, turns ``autocommit`` mode back on." msgstr "" +"El modo ``autocommit`` significa que la sentencias que modifican la base de " +"datos toman efecto de forma inmediata. Una sentencia ``BEGIN`` o " +"``SAVEPOINT`` deshabilitan el modo ``autocommit``, y un ``COMMIT``, un " +"``ROLLBACK``, o un ``RELEASE`` que terminan la transacción más externa, " +"habilitan de nuevo el modo ``autocommit``." #: ../Doc/library/sqlite3.rst:1031 msgid "" @@ -1189,6 +1639,9 @@ msgid "" "implicitly before a Data Modification Language (DML) statement (i.e. " "``INSERT``/``UPDATE``/``DELETE``/``REPLACE``)." msgstr "" +"El módulo de Python :mod:`sqlite3` emite por defecto una sentencia ``BEGIN`` " +"implícita antes de una sentencia tipo Lenguaje Manipulación de Datos (DML) " +"(es decir ``INSERT``/``UPDATE``/``DELETE``/``REPLACE``)." #: ../Doc/library/sqlite3.rst:1035 msgid "" @@ -1199,6 +1652,12 @@ msgid "" "specifying ``DEFERRED``. Other possible values are ``IMMEDIATE`` and " "``EXCLUSIVE``." msgstr "" +"Se puede controlar en qué tipo de sentencias ``BEGIN`` :mod:`sqlite3` " +"implícitamente ejecuta vía el parámetro *insolation_level* a la función de " +"llamada :func:`connect`, o vía las propiedades de conexión :attr:" +"`isolation_level`. Si no se especifica *isolation_level*, se usa un plano " +"``BEGIN``, el cuál es equivalente a especificar ``DEFERRED``. Otros posibles " +"valores son ``IMMEDIATE`` and ``EXCLUSIVE``." #: ../Doc/library/sqlite3.rst:1042 msgid "" @@ -1209,20 +1668,28 @@ msgid "" "``BEGIN``, ``ROLLBACK``, ``SAVEPOINT``, and ``RELEASE`` statements in your " "code." msgstr "" +"Se puede deshabilitar la gestión implícita de transacciones del módulo :mod:" +"`sqlite3` con la configuración :attr:`isolation_level` a ``None``. Esto " +"dejará la subyacente biblioteca operando en modo ``autocommit``. Se puede " +"controlar completamente el estado de la transacción emitiendo explícitamente " +"sentencias ``BEGIN``, ``ROLLBACK``, ``SAVEPOINT``, y ``RELEASE`` en el " +"código." #: ../Doc/library/sqlite3.rst:1048 msgid "" ":mod:`sqlite3` used to implicitly commit an open transaction before DDL " "statements. This is no longer the case." msgstr "" +":mod:`sqlite3` solía realizar commit en transacciones implícitamente antes " +"de sentencias DDL. Este ya no es el caso." #: ../Doc/library/sqlite3.rst:1054 msgid "Using :mod:`sqlite3` efficiently" -msgstr "" +msgstr "Usando :mod:`sqlite3` eficientemente" #: ../Doc/library/sqlite3.rst:1058 msgid "Using shortcut methods" -msgstr "" +msgstr "Usando métodos atajo" #: ../Doc/library/sqlite3.rst:1060 msgid "" @@ -1235,26 +1702,38 @@ msgid "" "iterate over it directly using only a single call on the :class:`Connection` " "object." msgstr "" +"Usando los métodos no estándar :meth:`execute`, :meth:`executemany` y :meth:" +"`executescript` del objeto :class:`Connection`, el código puede ser escrito " +"más consistentemente porque no se tienen que crear explícitamente los (a " +"menudo superfluos) objetos :class:`Cursor`. En cambio, los objetos de :class:" +"`Cursor` son creados implícitamente y estos métodos atajo retornan los " +"objetos cursor. De esta forma, se puede ejecutar una sentencia ``SELECT`` e " +"iterar directamente sobre él, solamente usando una única llamada al objeto :" +"class:`Connection`." #: ../Doc/library/sqlite3.rst:1072 msgid "Accessing columns by name instead of by index" -msgstr "" +msgstr "Accediendo a las columnas por el nombre en lugar del índice" #: ../Doc/library/sqlite3.rst:1074 msgid "" "One useful feature of the :mod:`sqlite3` module is the built-in :class:" "`sqlite3.Row` class designed to be used as a row factory." msgstr "" +"Una característica útil del módulo :mod:`sqlite3` es la clase incluida :" +"class:`sqlite3.Row` diseñada para ser usada como una fábrica de filas." #: ../Doc/library/sqlite3.rst:1077 msgid "" "Rows wrapped with this class can be accessed both by index (like tuples) and " "case-insensitively by name:" msgstr "" +"Filas envueltas con esta clase pueden ser accedidas tanto por índice (al " +"igual que tuplas) como por nombre insensible a mayúsculas o minúsculas:" #: ../Doc/library/sqlite3.rst:1084 msgid "Using the connection as a context manager" -msgstr "" +msgstr "Usando la conexión como un administrador de contexto" #: ../Doc/library/sqlite3.rst:1086 msgid "" @@ -1262,14 +1741,18 @@ msgid "" "or rollback transactions. In the event of an exception, the transaction is " "rolled back; otherwise, the transaction is committed:" msgstr "" +"Los objetos de conexión pueden ser usados como administradores de contexto " +"que automáticamente transacciones commit o rollback. En el evento de una " +"excepción, la transacción es retrocedida; de otra forma, la transacción es " +"confirmada:" #: ../Doc/library/sqlite3.rst:1095 msgid "Common issues" -msgstr "" +msgstr "Problemas comunes" #: ../Doc/library/sqlite3.rst:1098 msgid "Multithreading" -msgstr "" +msgstr "Multihilo" #: ../Doc/library/sqlite3.rst:1100 msgid "" @@ -1278,16 +1761,22 @@ msgid "" "between threads. If you still try to do so, you will get an exception at " "runtime." msgstr "" +"Versiones antiguas de SQLite tienen problemas compartiendo conexiones entre " +"hilos. Es por ello que el módulo de Python no permite compartir conexiones y " +"cursores entre hilos. Si se quiere intentar esto, se obtendrá una excepción " +"en tiempo de ejecución." #: ../Doc/library/sqlite3.rst:1104 msgid "" "The only exception is calling the :meth:`~Connection.interrupt` method, " "which only makes sense to call from a different thread." msgstr "" +"La única excepción es llamando el método :meth:`~Connection.interrupt`, el " +"cual solamente tiene sentido llamarlo desde un hilo diferente." #: ../Doc/library/sqlite3.rst:1108 msgid "Footnotes" -msgstr "" +msgstr "Notas al pie" #: ../Doc/library/sqlite3.rst:1109 msgid "" @@ -1296,3 +1785,8 @@ msgid "" "compiled without this feature. To get loadable extension support, you must " "pass --enable-loadable-sqlite-extensions to configure." msgstr "" +"El módulo sqlite3 no está compilado con una extensión cargable por defecto, " +"porqué algunas plataformas (notablemente Mac OS X) tienen bibliotecas SQLite " +"compiladas sin esta característica. Para obtener soporte de extensión " +"configurable, se debe pasar --enable-loadable-sqlite-extension para " +"configurar."