reydb 1.1.61__py3-none-any.whl → 1.2.1__py3-none-any.whl

reydb/rexec.py

@@ -18,13 +18,13 @@ from reykit.rdata import FunctionGenerator
 from reykit.rmonkey import monkey_sqlalchemy_result_more_fetch, monkey_sqlalchemy_row_index_field
 from reykit.rrand import randn
 from reykit.rre import findall
-from reykit.rstdout import echo
+from reykit.rstdout import echo as recho
 from reykit.rtable import TableData, Table
 from reykit.rtime import TimeMark, time_to
 from reykit.rwrap import wrap_runtime
 
 from . import rconn
-from .rbase import DatabaseBase, handle_sql, handle_data, extract_path
+from .rbase import DatabaseBase, handle_sql, handle_data
 
 
 __all__ = (
@@ -67,18 +67,18 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         self,
         sql: str | TextClause,
         data: TableData | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> tuple[TextClause, list[dict], bool]:
         """
-        Handle parameters before execute SQL.
+        Handle method of execute SQL.
 
         Parameters
         ----------
         sql : SQL in method `sqlalchemy.text` format, or `TextClause` object.
         data : Data set for filling.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
             - `bool`: Use this value.
         kwdata : Keyword parameters for filling.
 
@@ -88,7 +88,7 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        report = get_first_notnone(report, self.conn.db.report)
+        echo = get_first_notnone(echo, self.conn.db.echo)
         sql = handle_sql(sql)
         if data is None:
             if kwdata == {}:
@@ -102,12 +102,12 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
                 row.update(kwdata)
         data = handle_data(data, sql)
 
-        return sql, data, report
+        return sql, data, echo
 
 
     def handle_select(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         group: str | None = None,
@@ -116,11 +116,13 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         limit: int | str | tuple[int, int] | None = None
     ) -> str:
         """
-        Handle parameters before execute select SQL.
+        Handle method of execute select SQL.
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -141,9 +143,10 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        database = self.conn.db.database
-        if '.' in table:
-            database, table, _ = extract_path(table)
+        if type(path) == str:
+            database, table = self.conn.db.database, path
+        else:
+            database, table = path
 
         # Generate SQL.
         sql_list = []
@@ -209,17 +212,19 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
     def handle_insert(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         duplicate: Literal['ignore', 'update'] | Container[str] | None = None,
         **kwdata: Any
     ) -> Result:
         """
-        Handle parameters before execute insert SQL.
+        Handle method of execute insert SQL.
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Insert data.
         duplicate : Handle method when constraint error.
             - `None`: Not handled.
@@ -236,9 +241,10 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        database = self.conn.db.database
-        if '.' in table:
-            database, table, _ = extract_path(table)
+        if type(path) == str:
+            database, table = self.conn.db.database, path
+        else:
+            database, table = path
 
         ## Data.
         data_table = Table(data)
@@ -343,7 +349,7 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
     def handle_update(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         where_fields: str | Iterable[str] | None = None,
         **kwdata: Any
@@ -353,7 +359,9 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Update data, clause `SET` and `WHERE` and `ORDER BY` and `LIMIT` content.
             - `Key`: Table field.
                 `literal['order']`: Clause `ORDER BY` content, join as `ORDER BY str`.
@@ -376,9 +384,10 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        database = self.conn.db.database
-        if '.' in table:
-            database, table, _ = extract_path(table)
+        if type(path) == str:
+            database, table = self.conn.db.database, path
+        else:
+            database, table = path
 
         ## Data.
         data_table = Table(data)
@@ -486,7 +495,7 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
     def handle_delete(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
         order: str | None = None,
         limit: int | str | None = None
@@ -496,7 +505,9 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Clause `WHERE` content, join as `WHERE str`.
         order : Clause `ORDER BY` content, join as `ORDER BY str`.
         limit : Clause `LIMIT` content, join as `LIMIT int/str`.
@@ -507,9 +518,10 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        database = self.conn.db.database
-        if '.' in table:
-            database, table, _ = extract_path(table)
+        if type(path) == str:
+            database, table = self.conn.db.database, path
+        else:
+            database, table = path
 
         # Generate SQL.
         sqls = []
@@ -541,7 +553,7 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
     def handle_copy(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         limit: int | str | tuple[int, int] | None = None
@@ -551,7 +563,9 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -567,9 +581,10 @@ class DatabaseExecuteSuper(DatabaseBase, Generic[DatabaseConnectionT]):
         """
 
         # Handle parameter.
-        database = self.conn.db.database
-        if '.' in table:
-            database, table, _ = extract_path(table)
+        if type(path) == str:
+            database, table = self.conn.db.database, path
+        else:
+            database, table = path
         if fields is None:
             fields = '*'
         elif type(fields) != str:
@@ -623,7 +638,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         self,
         sql: str | TextClause,
         data: TableData | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -633,8 +648,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         ----------
         sql : SQL in method `sqlalchemy.text` format, or `TextClause` object.
         data : Data set for filling.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
             - `bool`: Use this value.
         kwdata : Keyword parameters for filling.
 
@@ -644,7 +659,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql, data, report = self.handle_execute(sql, data, report, **kwdata)
+        sql, data, echo = self.handle_execute(sql, data, echo, **kwdata)
 
         # Transaction.
         self.conn.get_begin()
@@ -652,7 +667,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         # Execute.
 
         ## Report.
-        if report:
+        if echo:
             execute = wrap_runtime(self.conn.connection.execute, to_return=True, to_print=False)
             result, report_runtime, *_ = execute(sql, data)
             report_info = (
@@ -665,9 +680,9 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
                 if sql_part != ''
             ]
             if data == []:
-                echo(report_info, *sqls, title='SQL')
+                recho(report_info, *sqls, title='SQL')
             else:
-                echo(report_info, *sqls, data, title='SQL')
+                recho(report_info, *sqls, data, title='SQL')
 
         ## Not report.
         else:
@@ -686,14 +701,14 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
     def select(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         group: str | None = None,
         having: str | None = None,
         order: str | None = None,
         limit: int | str | tuple[int, int] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -701,7 +716,9 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -715,8 +732,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         limit : Clause `LIMIT` content.
             - `int | str`: Join as `LIMIT int/str`.
             - `tuple[int, int]`: Join as `LIMIT int, int`.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -739,20 +756,20 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql = self.handle_select(table, fields, where, group, having, order, limit)
+        sql = self.handle_select(path, fields, where, group, having, order, limit)
 
         # Execute SQL.
-        result = self.execute(sql, report=report, **kwdata)
+        result = self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     def insert(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         duplicate: Literal['ignore', 'update'] | Container[str] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -760,15 +777,17 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Insert data.
         duplicate : Handle method when constraint error.
             - `None`: Not handled.
             - `ignore`: Use `UPDATE IGNORE INTO` clause.
             - `update`: Use `ON DUPLICATE KEY UPDATE` clause and update all fields.
             - `Container[str]`: Use `ON DUPLICATE KEY UPDATE` clause and update this fields.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
             - `str and first character is ':'`: Use this syntax.
             - `Any`: Use this value.
@@ -779,7 +798,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `data` and `kwdata`.
         >>> data = [{'key': 'a'}, {'key': 'b'}]
         >>> kwdata = {'value1': 1, 'value2': ':(SELECT 2)'}
         >>> result = Database.execute.insert('table', data, **kwdata)
@@ -791,20 +809,20 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql, kwdata = self.handle_insert(table, data, duplicate, **kwdata)
+        sql, kwdata = self.handle_insert(path, data, duplicate, **kwdata)
 
         # Execute SQL.
-        result = self.execute(sql, data, report, **kwdata)
+        result = self.execute(sql, data, echo, **kwdata)
 
         return result
 
 
     def update(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         where_fields: str | Iterable[str] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -812,7 +830,9 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Update data, clause `SET` and `WHERE` and `ORDER BY` and `LIMIT` content.
             - `Key`: Table field.
                 `literal['order']`: Clause `ORDER BY` content, join as `ORDER BY str`.
@@ -825,8 +845,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
             - `None`: The first key value pair of each item is judged.
             - `str`: This key value pair of each item is judged.
             - `Iterable[str]`: Multiple judged, `and`: relationship.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
             - `str and first character is ':'`: Use this syntax.
             - `Any`: Use this value.
@@ -837,7 +857,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `data` and `kwdata`.
         >>> data = [{'key': 'a'}, {'key': 'b'}]
         >>> kwdata = {'value': 1, 'name': ':`key`'}
         >>> result = Database.execute.update('table', data, **kwdata)
@@ -849,21 +868,21 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql, data = self.handle_update(table, data, where_fields, **kwdata)
+        sql, data = self.handle_update(path, data, where_fields, **kwdata)
 
         # Execute SQL.
-        result = self.execute(sql, data, report)
+        result = self.execute(sql, data, echo)
 
         return result
 
 
     def delete(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
         order: str | None = None,
         limit: int | str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -871,12 +890,14 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Clause `WHERE` content, join as `WHERE str`.
         order : Clause `ORDER BY` content, join as `ORDER BY str`.
         limit : Clause `LIMIT` content, join as `LIMIT int/str`.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -885,7 +906,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2)
         >>> result = Database.execute.delete('table', where, ids=ids)
@@ -894,21 +914,21 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql = self.handle_delete(table, where, order, limit)
+        sql = self.handle_delete(path, where, order, limit)
 
         # Execute SQL.
-        result = self.execute(sql, report=report, **kwdata)
+        result = self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     def copy(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         limit: int | str | tuple[int, int] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -916,7 +936,9 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -925,6 +947,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         limit : Clause `LIMIT` content.
             - `int | str`: Join as `LIMIT int/str`.
             - `tuple[int, int]`: Join as `LIMIT int, int`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -933,7 +957,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2, 3)
         >>> result = Database.execute.copy('table', where, 2, ids=ids, id=None, time=':NOW()')
@@ -942,19 +965,19 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Handle parameter.
-        sql = self.handle_copy(table, fields, where, limit)
+        sql = self.handle_copy(path, fields, where, limit)
 
         # Execute SQL.
-        result = self.execute(sql, report=report, **kwdata)
+        result = self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     def count(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> int:
         """
@@ -962,12 +985,14 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Match condition, `WHERE` clause content, join as `WHERE str`.
             - `None`: Match all.
             - `str`: Match condition.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -976,7 +1001,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2)
         >>> result = Database.execute.count('table', where, ids=ids)
@@ -985,7 +1009,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Execute.
-        result = self.select(table, '1', where=where, report=report, **kwdata)
+        result = self.select(path, '1', where=where, echo=echo, **kwdata)
         count = len(tuple(result))
 
         return count
@@ -993,9 +1017,9 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
     def exist(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> bool:
         """
@@ -1003,12 +1027,14 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Match condition, `WHERE` clause content, join as `WHERE str`.
             - `None`: Match all.
             - `str`: Match condition.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1017,7 +1043,6 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> data = [{'id': 1}]
         >>> Database.execute.insert('table', data)
         >>> where = '`id` = :id_'
@@ -1028,7 +1053,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         """
 
         # Execute.
-        result = self.count(table, where, report, **kwdata)
+        result = self.count(path, where, echo, **kwdata)
 
         # Judge.
         judge = result != 0
@@ -1040,7 +1065,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         self,
         sql: str | TextClause,
         data: TableData,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Generator[Result, Any, None]:
         """
@@ -1050,8 +1075,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         ----------
         sql : SQL in method `sqlalchemy.text` format, or `TextClause` object.
         data : Data set for filling.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
             - `bool`: Use this value.
         kwdata : Keyword parameters for filling.
 
@@ -1064,7 +1089,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         func_generator = FunctionGenerator(
             self.execute,
             sql=sql,
-            report=report,
+            echo=echo,
             **kwdata
         )
 
@@ -1079,24 +1104,24 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
 
     @overload
-    def sleep(self, report: bool | None = None) -> int: ...
+    def sleep(self, echo: bool | None = None) -> int: ...
 
     @overload
-    def sleep(self, second: int, report: bool | None = None) -> int: ...
+    def sleep(self, second: int, echo: bool | None = None) -> int: ...
 
     @overload
-    def sleep(self, low: int = 0, high: int = 10, report: bool | None = None) -> int: ...
+    def sleep(self, low: int = 0, high: int = 10, echo: bool | None = None) -> int: ...
 
     @overload
-    def sleep(self, *thresholds: float, report: bool | None = None) -> float: ...
+    def sleep(self, *thresholds: float, echo: bool | None = None) -> float: ...
 
     @overload
-    def sleep(self, *thresholds: float, precision: Literal[0], report: bool | None = None) -> int: ...
+    def sleep(self, *thresholds: float, precision: Literal[0], echo: bool | None = None) -> int: ...
 
     @overload
-    def sleep(self, *thresholds: float, precision: int, report: bool | None = None) -> float: ...
+    def sleep(self, *thresholds: float, precision: int, echo: bool | None = None) -> float: ...
 
-    def sleep(self, *thresholds: float, precision: int | None = None, report: bool | None = None) -> float:
+    def sleep(self, *thresholds: float, precision: int | None = None, echo: bool | None = None) -> float:
         """
         Let the database wait random seconds.
 
@@ -1109,8 +1134,8 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
         precision : Precision of random range, that is maximum decimal digits of return value.
             - `None`: Set to Maximum decimal digits of element of parameter `thresholds`.
             - `int`: Set to this value.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
             - `bool`: Use this value.
 
         Returns
@@ -1128,7 +1153,7 @@ class DatabaseExecute(DatabaseExecuteSuper['rconn.DatabaseConnection']):
 
         # Sleep.
         sql = f'SELECT SLEEP({second})'
-        self.execute(sql, report=report)
+        self.execute(sql, echo=echo)
 
         return second
 
@@ -1143,7 +1168,7 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         self,
         sql: str | TextClause,
         data: TableData | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1153,9 +1178,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         ----------
         sql : SQL in method `sqlalchemy.text` format, or `TextClause` object.
         data : Data set for filling.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `DatabaseAsync.report`.
-            - `bool`: Use this value.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1164,7 +1188,7 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         """
 
         # Handle parameter.
-        sql, data, report = self.handle_execute(sql, data, report, **kwdata)
+        sql, data, echo = self.handle_execute(sql, data, echo, **kwdata)
 
         # Transaction.
         await self.conn.get_begin()
@@ -1172,7 +1196,7 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         # Execute.
 
         ## Report.
-        if report:
+        if echo:
             tm = TimeMark()
             tm()
             result = await self.conn.connection.execute(sql, data)
@@ -1201,9 +1225,9 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
             ]
 
             if data == []:
-                echo(report_info, *sqls, title='SQL')
+                recho(report_info, *sqls, title='SQL')
             else:
-                echo(report_info, *sqls, data, title='SQL')
+                recho(report_info, *sqls, data, title='SQL')
 
         ## Not report.
         else:
@@ -1223,14 +1247,14 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
     async def select(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         group: str | None = None,
         having: str | None = None,
         order: str | None = None,
         limit: int | str | tuple[int, int] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1238,7 +1262,9 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -1252,8 +1278,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         limit : Clause `LIMIT` content.
             - `int | str`: Join as `LIMIT int/str`.
             - `tuple[int, int]`: Join as `LIMIT int, int`.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1264,32 +1290,32 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         --------
         Parameter `fields`.
         >>> fields = ['id', ':`id` + 1 AS `id_`']
-        >>> result = Database.execute.select('table', fields)
+        >>> result = await Database.execute.select('table', fields)
         >>> print(result.to_table())
         [{'id': 1, 'id_': 2}, ...]
 
         Parameter `kwdata`.
         >>> fields = '`id`, `id` + :value AS `id_`'
-        >>> result = Database.execute.select('table', fields, value=1)
+        >>> result = await Database.execute.select('table', fields, value=1)
         >>> print(result.to_table())
         [{'id': 1, 'id_': 2}, ...]
         """
 
         # Handle parameter.
-        sql = self.handle_select(table, fields, where, group, having, order, limit)
+        sql = self.handle_select(path, fields, where, group, having, order, limit)
 
         # Execute SQL.
-        result = await self.execute(sql, report=report, **kwdata)
+        result = await self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     async def insert(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         duplicate: Literal['ignore', 'update'] | Container[str] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1297,15 +1323,17 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Insert data.
         duplicate : Handle method when constraint error.
             - `None`: Not handled.
             - `ignore`: Use `UPDATE IGNORE INTO` clause.
             - `update`: Use `ON DUPLICATE KEY UPDATE` clause and update all fields.
             - `Container[str]`: Use `ON DUPLICATE KEY UPDATE` clause and update this fields.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
             - `str and first character is ':'`: Use this syntax.
             - `Any`: Use this value.
@@ -1316,32 +1344,31 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `data` and `kwdata`.
         >>> data = [{'key': 'a'}, {'key': 'b'}]
         >>> kwdata = {'value1': 1, 'value2': ':(SELECT 2)'}
-        >>> result = Database.execute.insert('table', data, **kwdata)
+        >>> result = await Database.execute.insert('table', data, **kwdata)
         >>> print(result.rowcount)
         2
-        >>> result = Database.execute.select('table')
+        >>> result = await Database.execute.select('table')
         >>> print(result.to_table())
         [{'key': 'a', 'value1': 1, 'value2': 2}, {'key': 'b', 'value1': 1, 'value2': 2}]
         """
 
         # Handle parameter.
-        sql, kwdata = self.handle_insert(table, data, duplicate, **kwdata)
+        sql, kwdata = self.handle_insert(path, data, duplicate, **kwdata)
 
         # Execute SQL.
-        result = await self.execute(sql, data, report, **kwdata)
+        result = await self.execute(sql, data, echo, **kwdata)
 
         return result
 
 
     async def update(
         self,
-        table: str,
+        path: str | tuple[str, str],
         data: TableData,
         where_fields: str | Iterable[str] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1349,7 +1376,9 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         data : Update data, clause `SET` and `WHERE` and `ORDER BY` and `LIMIT` content.
             - `Key`: Table field.
                 `literal['order']`: Clause `ORDER BY` content, join as `ORDER BY str`.
@@ -1362,8 +1391,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
             - `None`: The first key value pair of each item is judged.
             - `str`: This key value pair of each item is judged.
             - `Iterable[str]`: Multiple judged, `and`: relationship.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
             - `str and first character is ':'`: Use this syntax.
             - `Any`: Use this value.
@@ -1374,33 +1403,32 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `data` and `kwdata`.
         >>> data = [{'key': 'a'}, {'key': 'b'}]
         >>> kwdata = {'value': 1, 'name': ':`key`'}
-        >>> result = Database.execute.update('table', data, **kwdata)
+        >>> result = await Database.execute.update('table', data, **kwdata)
         >>> print(result.rowcount)
         2
-        >>> result = Database.execute.select('table')
+        >>> result = await Database.execute.select('table')
         >>> print(result.to_table())
         [{'key': 'a', 'value': 1, 'name': 'a'}, {'key': 'b', 'value': 1, 'name': 'b'}]
         """
 
         # Handle parameter.
-        sql, data = self.handle_update(table, data, where_fields, **kwdata)
+        sql, data = self.handle_update(path, data, where_fields, **kwdata)
 
         # Execute SQL.
-        result = await self.execute(sql, data, report)
+        result = await self.execute(sql, data, echo)
 
         return result
 
 
     async def delete(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
         order: str | None = None,
         limit: int | str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1408,12 +1436,14 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Clause `WHERE` content, join as `WHERE str`.
         order : Clause `ORDER BY` content, join as `ORDER BY str`.
         limit : Clause `LIMIT` content, join as `LIMIT int/str`.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1422,30 +1452,29 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2)
-        >>> result = Database.execute.delete('table', where, ids=ids)
+        >>> result = await Database.execute.delete('table', where, ids=ids)
         >>> print(result.rowcount)
         2
         """
 
         # Handle parameter.
-        sql = self.handle_delete(table, where, order, limit)
+        sql = self.handle_delete(path, where, order, limit)
 
         # Execute SQL.
-        result = await self.execute(sql, report=report, **kwdata)
+        result = await self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     async def copy(
         self,
-        table: str,
+        path: str | tuple[str, str],
         fields: str | Iterable[str] | None = None,
         where: str | None = None,
         limit: int | str | tuple[int, int] | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> Result:
         """
@@ -1453,7 +1482,9 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         fields : Select clause content.
             - `None`: Is `SELECT *`.
             - `str`: Join as `SELECT str`.
@@ -1462,6 +1493,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         limit : Clause `LIMIT` content.
             - `int | str`: Join as `LIMIT int/str`.
             - `tuple[int, int]`: Join as `LIMIT int, int`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1470,28 +1503,27 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2, 3)
-        >>> result = Database.execute.copy('table', where, 2, ids=ids, id=None, time=':NOW()')
+        >>> result = await Database.execute.copy('table', ['name', 'value'], where, 2, ids=ids)
         >>> print(result.rowcount)
         2
         """
 
         # Handle parameter.
-        sql = self.handle_copy(table, fields, where, limit)
+        sql = self.handle_copy(path, fields, where, limit)
 
         # Execute SQL.
-        result = await self.execute(sql, report=report, **kwdata)
+        result = await self.execute(sql, echo=echo, **kwdata)
 
         return result
 
 
     async def count(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> int:
         """
@@ -1499,12 +1531,14 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Match condition, `WHERE` clause content, join as `WHERE str`.
             - `None`: Match all.
             - `str`: Match condition.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1513,16 +1547,15 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> where = '`id` IN :ids'
         >>> ids = (1, 2)
-        >>> result = Database.execute.count('table', where, ids=ids)
+        >>> result = await Database.execute.count('table', where, ids=ids)
         >>> print(result)
         2
         """
 
         # Execute.
-        result = await self.select(table, '1', where=where, report=report, **kwdata)
+        result = await self.select(path, '1', where=where, echo=echo, **kwdata)
         count = len(tuple(result))
 
         return count
@@ -1530,9 +1563,9 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
     async def exist(
         self,
-        table: str,
+        path: str | tuple[str, str],
         where: str | None = None,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> bool:
         """
@@ -1540,12 +1573,14 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Parameters
         ----------
-        table : Table name, can include database name.
+        path : Path.
+            - `str`: Table name.
+            - `tuple[str, str]`: Database name and table name.
         where : Match condition, `WHERE` clause content, join as `WHERE str`.
             - `None`: Match all.
             - `str`: Match condition.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `Database.report`.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1554,18 +1589,17 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         Examples
         --------
-        Parameter `where` and `kwdata`.
         >>> data = [{'id': 1}]
         >>> Database.execute.insert('table', data)
         >>> where = '`id` = :id_'
         >>> id_ = 1
-        >>> result = Database.execute.exist('table', where, id_=id_)
+        >>> result = await Database.execute.exist('table', where, id_=id_)
         >>> print(result)
         True
         """
 
         # Execute.
-        result = await self.count(table, where, report, **kwdata)
+        result = await self.count(path, where, echo, **kwdata)
 
         # Judge.
         judge = result != 0
@@ -1577,7 +1611,7 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         self,
         sql: str | TextClause,
         data: TableData,
-        report: bool | None = None,
+        echo: bool | None = None,
         **kwdata: Any
     ) -> AsyncGenerator[Result, Any]:
         """
@@ -1587,9 +1621,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         ----------
         sql : SQL in method `sqlalchemy.text` format, or `TextClause` object.
         data : Data set for filling.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `DatabaseAsync.report`.
-            - `bool`: Use this value.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
         kwdata : Keyword parameters for filling.
 
         Returns
@@ -1601,7 +1634,7 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         func_generator = FunctionGenerator(
             self.execute,
             sql=sql,
-            report=report,
+            echo=echo,
             **kwdata
         )
 
@@ -1616,24 +1649,24 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
 
     @overload
-    async def sleep(self, report: bool | None = None) -> int: ...
+    async def sleep(self, echo: bool | None = None) -> int: ...
 
     @overload
-    async def sleep(self, second: int, report: bool | None = None) -> int: ...
+    async def sleep(self, second: int, echo: bool | None = None) -> int: ...
 
     @overload
-    async def sleep(self, low: int = 0, high: int = 10, report: bool | None = None) -> int: ...
+    async def sleep(self, low: int = 0, high: int = 10, echo: bool | None = None) -> int: ...
 
     @overload
-    async def sleep(self, *thresholds: float, report: bool | None = None) -> float: ...
+    async def sleep(self, *thresholds: float, echo: bool | None = None) -> float: ...
 
     @overload
-    async def sleep(self, *thresholds: float, precision: Literal[0], report: bool | None = None) -> int: ...
+    async def sleep(self, *thresholds: float, precision: Literal[0], echo: bool | None = None) -> int: ...
 
     @overload
-    async def sleep(self, *thresholds: float, precision: int, report: bool | None = None) -> float: ...
+    async def sleep(self, *thresholds: float, precision: int, echo: bool | None = None) -> float: ...
 
-    async def sleep(self, *thresholds: float, precision: int | None = None, report: bool | None = None) -> float:
+    async def sleep(self, *thresholds: float, precision: int | None = None, echo: bool | None = None) -> float:
         """
         Asynchronous let the database wait random seconds.
 
@@ -1646,9 +1679,8 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
         precision : Precision of random range, that is maximum decimal digits of return value.
             - `None`: Set to Maximum decimal digits of element of parameter `thresholds`.
             - `int`: Set to this value.
-        report : Whether report SQL execute information.
-            - `None`: Use attribute `DatabaseAsync.report`.
-            - `bool`: Use this value.
+        echo : Whether report SQL execute information.
+            - `None`: Use attribute `Database.echo`.
 
         Returns
         -------
@@ -1665,6 +1697,6 @@ class DatabaseExecuteAsync(DatabaseExecuteSuper['rconn.DatabaseConnectionAsync']
 
         # Sleep.
         sql = f'SELECT SLEEP({second})'
-        await self.execute(sql, report=report)
+        await self.execute(sql, echo=echo)
 
         return second