id,page,ref,title,content,breadcrumbs,references
internals:datasette-add-database,internals,datasette-add-database,".add_database(db, name=None, route=None)","db  - datasette.database.Database instance 
                         
                             The database to be attached. 
                         
                     
                     
                         name  - string, optional 
                         
                             The name to be used for this database . If not specified Datasette will pick one based on the filename or memory name. 
                         
                     
                     
                         route  - string, optional 
                         
                             This will be used in the URL path. If not specified, it will default to the same thing as the  name . 
                         
                     
                 
                 The  datasette.add_database(db)  method lets you add a new database to the current Datasette instance. 
                 The  db  parameter should be an instance of the  datasette.database.Database  class. For example: 
                 from datasette.database import Database

datasette.add_database(
    Database(
        datasette,
        path=""path/to/my-new-database.db"",
    )
) 
                 This will add a mutable database and serve it at  /my-new-database . 
                 Use  is_mutable=False  to add an immutable database. 
                 .add_database()  returns the Database instance, with its name set as the  database.name  attribute. Any time you are working with a newly added database you should use the return value of  .add_database() , for example: 
                 db = datasette.add_database(
    Database(datasette, memory_name=""statistics"")
)
await db.execute_write(
    ""CREATE TABLE foo(id integer primary key)""
)","[""Internals for plugins"", ""Datasette class""]",[]