Method db

tortoise/context.py:438–468

Get a database connection by name. Args: connection_name: The connection alias. If None, uses the default connection. With a single connection, it becomes the default automatically. With multiple connections, eithe

(self, connection_name: str | None = None)

        return self._apps.get_model(app_label, model_name)

    def db(self, connection_name: str | None = None) -> BaseDBAsyncClient:
        """
        Get a database connection by name.

        Args:
            connection_name: The connection alias. If None, uses the default connection.
                            With a single connection, it becomes the default automatically.
                            With multiple connections, either specify explicitly or
                            configure one as "default".

        Returns:
            The database client for the specified connection.

        Raises:
            ConfigurationError: If context not initialized, connection not found,
                               or no default connection when multiple exist.
        """
        if not self._inited:
            raise ConfigurationError(
                "Context not initialized. Call init() before accessing database."
            )

        if connection_name is None:
            if self._default_connection is None:
                raise ConfigurationError(
                    "No default connection configured. Either use a single connection, "
                    "name one 'default', or specify connection_name explicitly."
                )
            connection_name = self._default_connection

        return self.connections.get(connection_name)

    async def close_connections(self) -> None:
        """