[{"data":1,"prerenderedAt":887},["ShallowReactive",2],{"navigation":3,"-guide-database":234,"-guide-database-surround":882},[4,81,228],{"title":5,"path":6,"stem":7,"children":8,"icon":10},"Getting Started","/guide","1.guide/0.index",[9,11,16,21,26,31,36,41,46,51,56,61,66,71,76],{"title":5,"path":6,"stem":7,"icon":10},"ph:book-open-duotone",{"title":12,"path":13,"stem":14,"icon":15},"Migration Guide","/guide/migration","1.guide/00.migration","ri:arrow-right-up-line",{"title":17,"path":18,"stem":19,"icon":20},"Server Utils","/guide/utils","1.guide/1.utils","ri:tools-line",{"title":22,"path":23,"stem":24,"icon":25},"Tasks","/guide/tasks","1.guide/10.tasks","codicon:run-all",{"title":27,"path":28,"stem":29,"icon":30},"Server Routes","/guide/routing","1.guide/2.routing","ri:direction-line",{"title":32,"path":33,"stem":34,"icon":35},"WebSocket","/guide/websocket","1.guide/3.websocket","cib:socket-io",{"title":37,"path":38,"stem":39,"icon":40},"KV Storage","/guide/storage","1.guide/4.storage","carbon:datastore",{"title":42,"path":43,"stem":44,"icon":45},"SQL Database","/guide/database","1.guide/5.database","ri:database-2-line",{"title":47,"path":48,"stem":49,"icon":50},"Cache","/guide/cache","1.guide/6.cache","ri:speed-line",{"title":52,"path":53,"stem":54,"icon":55},"Fetch","/guide/fetch","1.guide/7.fetch","ri:global-line",{"title":57,"path":58,"stem":59,"icon":60},"Assets","/guide/assets","1.guide/8.assets","ri:image-2-line",{"title":62,"path":63,"stem":64,"icon":65},"Plugins","/guide/plugins","1.guide/9.plugins","ri:plug-line",{"title":67,"path":68,"stem":69,"icon":70},"Configuration","/guide/configuration","1.guide/97.configuration","ri:settings-3-line",{"title":72,"path":73,"stem":74,"icon":75},"TypeScript","/guide/typescript","1.guide/98.typescript","tabler:brand-typescript",{"title":77,"path":78,"stem":79,"icon":80},"Nightly Channel","/guide/nightly","1.guide/99.nightly","ri:moon-fill",{"title":82,"path":83,"stem":84,"children":85,"icon":87},"Overview","/deploy","2.deploy/0.index",[86,88,92,122,127],{"title":82,"path":83,"stem":84,"icon":87},"ri:upload-cloud-2-line",{"title":89,"path":90,"stem":91,"icon":55},"Edge Workers","/deploy/workers","2.deploy/1.workers",{"title":93,"path":94,"stem":95,"children":96,"page":121},"Runtimes","/deploy/runtimes","2.deploy/10.runtimes",[97,102,106,111,116],{"title":98,"path":99,"stem":100,"icon":101},"Node.js","/deploy/runtimes/node","2.deploy/10.runtimes/1.node","akar-icons:node-fill",{"title":103,"path":104,"stem":105,"icon":25},"Dir","/deploy/runtimes/_dir","2.deploy/10.runtimes/_dir",{"title":107,"path":108,"stem":109,"icon":110},"WinterJS","/deploy/runtimes/_winterjs","2.deploy/10.runtimes/_winterjs","game-icons:cold-heart",{"title":112,"path":113,"stem":114,"icon":115},"Bun","/deploy/runtimes/bun","2.deploy/10.runtimes/bun","simple-icons:bun",{"title":117,"path":118,"stem":119,"icon":120},"Deno","/deploy/runtimes/deno","2.deploy/10.runtimes/deno","simple-icons:deno",false,{"title":123,"path":124,"stem":125,"icon":126},"Custom Preset","/deploy/custom-presets","2.deploy/2.custom-presets","ri:file-code-line",{"title":128,"path":129,"stem":130,"children":131,"page":121},"Providers","/deploy/providers","2.deploy/20.providers",[132,136,140,144,148,152,156,160,164,168,172,176,180,184,188,192,196,200,204,208,212,216,220,224],{"title":103,"path":133,"stem":134,"icon":135},"/deploy/providers/_dir","2.deploy/20.providers/_dir","tdesign:cloud",{"title":137,"path":138,"stem":139},"Alwaysdata","/deploy/providers/alwaysdata","2.deploy/20.providers/alwaysdata",{"title":141,"path":142,"stem":143},"AWS Lambda","/deploy/providers/aws","2.deploy/20.providers/aws",{"title":145,"path":146,"stem":147},"AWS Amplify","/deploy/providers/aws-amplify","2.deploy/20.providers/aws-amplify",{"title":149,"path":150,"stem":151},"Azure","/deploy/providers/azure","2.deploy/20.providers/azure",{"title":153,"path":154,"stem":155},"Cleavr","/deploy/providers/cleavr","2.deploy/20.providers/cleavr",{"title":157,"path":158,"stem":159},"Cloudflare","/deploy/providers/cloudflare","2.deploy/20.providers/cloudflare",{"title":161,"path":162,"stem":163},"Deno Deploy","/deploy/providers/deno-deploy","2.deploy/20.providers/deno-deploy",{"title":165,"path":166,"stem":167},"DigitalOcean","/deploy/providers/digitalocean","2.deploy/20.providers/digitalocean",{"title":169,"path":170,"stem":171},"Firebase","/deploy/providers/firebase","2.deploy/20.providers/firebase",{"title":173,"path":174,"stem":175},"Flightcontrol","/deploy/providers/flightcontrol","2.deploy/20.providers/flightcontrol",{"title":177,"path":178,"stem":179},"Genezio","/deploy/providers/genezio","2.deploy/20.providers/genezio",{"title":181,"path":182,"stem":183},"GitHub Pages","/deploy/providers/github-pages","2.deploy/20.providers/github-pages",{"title":185,"path":186,"stem":187},"GitLab Pages","/deploy/providers/gitlab-pages","2.deploy/20.providers/gitlab-pages",{"title":189,"path":190,"stem":191},"Heroku","/deploy/providers/heroku","2.deploy/20.providers/heroku",{"title":193,"path":194,"stem":195},"IIS","/deploy/providers/iis","2.deploy/20.providers/iis",{"title":197,"path":198,"stem":199},"Koyeb","/deploy/providers/koyeb","2.deploy/20.providers/koyeb",{"title":201,"path":202,"stem":203},"Netlify","/deploy/providers/netlify","2.deploy/20.providers/netlify",{"title":205,"path":206,"stem":207},"Platform.sh","/deploy/providers/platform-sh","2.deploy/20.providers/platform-sh",{"title":209,"path":210,"stem":211},"Render.com","/deploy/providers/render","2.deploy/20.providers/render",{"title":213,"path":214,"stem":215},"StormKit","/deploy/providers/stormkit","2.deploy/20.providers/stormkit",{"title":217,"path":218,"stem":219},"Vercel","/deploy/providers/vercel","2.deploy/20.providers/vercel",{"title":221,"path":222,"stem":223},"Zeabur","/deploy/providers/zeabur","2.deploy/20.providers/zeabur",{"title":225,"path":226,"stem":227},"Zerops","/deploy/providers/zerops","2.deploy/20.providers/zerops",{"title":229,"path":230,"stem":231,"children":232,"icon":70},"Config","/config","3.config/0.index",[233],{"title":229,"path":230,"stem":231,"icon":70},{"id":235,"title":42,"body":236,"description":876,"extension":877,"meta":878,"navigation":879,"path":43,"seo":880,"stem":44,"__hash__":881},"content/1.guide/5.database.md",{"type":237,"value":238,"toc":871,"icon":45},"minimark",[239,261,271,281,286,291,303,306,416,420,652,655,662,858,867],[240,241,242,243,247,248,255,256,260],"p",{},"The default database connection is ",[244,245,246],"strong",{},"preconfigured"," with ",[249,250,254],"a",{"href":251,"rel":252},"https://db0.unjs.io/connectors/sqlite",[253],"nofollow","SQLite"," and works out of the box for development mode and any Node.js compatible production deployments. By default, data will be stored in ",[257,258,259],"code",{},".data/db.sqlite",".",[262,263,264],"tip",{},[240,265,266,267,260],{},"\nYou can change default connection or define more connections to any of the ",[249,268,270],{"href":251,"rel":269},[253],"supported databases",[262,272,273],{},[240,274,275,276,260],{},"\nYou can integrate database instance to any of the ",[249,277,280],{"href":278,"rel":279},"https://db0.unjs.io/integrations",[253],"supported ORMs",[282,283],"read-more",{"title":284,"to":285},"DB0 Documentation","https://db0.unjs.io",[287,288,290],"h2",{"id":289},"opt-in-to-the-experimental-feature","Opt-in to the experimental feature",[292,293,294],"important",{},[240,295,296,297,302],{},"\nDatabase support is currently experimental.\nRefer to the ",[249,298,301],{"href":299,"rel":300},"https://github.com/unjs/db0/issues",[253],"db0 issues"," for status and bug report.",[240,304,305],{},"In order to enable database layer you need to enable experimental feature flag.",[307,308,309,367],"code-group",{},[310,311,317],"pre",{"className":312,"code":313,"filename":314,"language":315,"meta":316,"style":316},"language-ts shiki shiki-themes github-light github-dark github-dark","export default defineNitroConfig({\n  experimental: {\n    database: true\n  }\n})\n","nitro.config.ts","ts","",[257,318,319,339,345,355,361],{"__ignoreMap":316},[320,321,324,328,331,335],"span",{"class":322,"line":323},"line",1,[320,325,327],{"class":326},"so5gQ","export",[320,329,330],{"class":326}," default",[320,332,334],{"class":333},"shcOC"," defineNitroConfig",[320,336,338],{"class":337},"slsVL","({\n",[320,340,342],{"class":322,"line":341},2,[320,343,344],{"class":337},"  experimental: {\n",[320,346,348,351],{"class":322,"line":347},3,[320,349,350],{"class":337},"    database: ",[320,352,354],{"class":353},"suiK_","true\n",[320,356,358],{"class":322,"line":357},4,[320,359,360],{"class":337},"  }\n",[320,362,364],{"class":322,"line":363},5,[320,365,366],{"class":337},"})\n",[310,368,371],{"className":312,"code":369,"filename":370,"language":315,"meta":316,"style":316},"export default defineNuxtConfig({\n  nitro: {\n    experimental: {\n      database: true\n    }\n  }\n})\n","nuxt.config.ts",[257,372,373,384,389,394,401,406,411],{"__ignoreMap":316},[320,374,375,377,379,382],{"class":322,"line":323},[320,376,327],{"class":326},[320,378,330],{"class":326},[320,380,381],{"class":333}," defineNuxtConfig",[320,383,338],{"class":337},[320,385,386],{"class":322,"line":341},[320,387,388],{"class":337},"  nitro: {\n",[320,390,391],{"class":322,"line":347},[320,392,393],{"class":337},"    experimental: {\n",[320,395,396,399],{"class":322,"line":357},[320,397,398],{"class":337},"      database: ",[320,400,354],{"class":353},[320,402,403],{"class":322,"line":363},[320,404,405],{"class":337},"    }\n",[320,407,409],{"class":322,"line":408},6,[320,410,360],{"class":337},[320,412,414],{"class":322,"line":413},7,[320,415,366],{"class":337},[287,417,419],{"id":418},"usage","Usage",[310,421,424],{"className":312,"code":422,"filename":423,"language":315,"meta":316,"style":316},"export default defineEventHandler(async () => {\n  const db = useDatabase();\n\n  // Create users table\n  await db.sql`DROP TABLE IF EXISTS users`;\n  await db.sql`CREATE TABLE IF NOT EXISTS users (\"id\" TEXT PRIMARY KEY, \"firstName\" TEXT, \"lastName\" TEXT, \"email\" TEXT)`;\n\n  // Add a new user\n  const userId = String(Math.round(Math.random() * 10_000));\n  await db.sql`INSERT INTO users VALUES (${userId}, 'John', 'Doe', '')`;\n\n  // Query for users\n  const { rows } = await db.sql`SELECT * FROM users WHERE id = ${userId}`;\n\n  return {\n    rows,\n  };\n});\n","index.ts",[257,425,426,450,467,473,479,497,510,514,520,556,576,581,587,621,626,634,640,646],{"__ignoreMap":316},[320,427,428,430,432,435,438,441,444,447],{"class":322,"line":323},[320,429,327],{"class":326},[320,431,330],{"class":326},[320,433,434],{"class":333}," defineEventHandler",[320,436,437],{"class":337},"(",[320,439,440],{"class":326},"async",[320,442,443],{"class":337}," () ",[320,445,446],{"class":326},"=>",[320,448,449],{"class":337}," {\n",[320,451,452,455,458,461,464],{"class":322,"line":341},[320,453,454],{"class":326},"  const",[320,456,457],{"class":353}," db",[320,459,460],{"class":326}," =",[320,462,463],{"class":333}," useDatabase",[320,465,466],{"class":337},"();\n",[320,468,469],{"class":322,"line":347},[320,470,472],{"emptyLinePlaceholder":471},true,"\n",[320,474,475],{"class":322,"line":357},[320,476,478],{"class":477},"sCsY4","  // Create users table\n",[320,480,481,484,487,490,494],{"class":322,"line":363},[320,482,483],{"class":326},"  await",[320,485,486],{"class":337}," db.",[320,488,489],{"class":333},"sql",[320,491,493],{"class":492},"sfrk1","`DROP TABLE IF EXISTS users`",[320,495,496],{"class":337},";\n",[320,498,499,501,503,505,508],{"class":322,"line":408},[320,500,483],{"class":326},[320,502,486],{"class":337},[320,504,489],{"class":333},[320,506,507],{"class":492},"`CREATE TABLE IF NOT EXISTS users (\"id\" TEXT PRIMARY KEY, \"firstName\" TEXT, \"lastName\" TEXT, \"email\" TEXT)`",[320,509,496],{"class":337},[320,511,512],{"class":322,"line":413},[320,513,472],{"emptyLinePlaceholder":471},[320,515,517],{"class":322,"line":516},8,[320,518,519],{"class":477},"  // Add a new user\n",[320,521,523,525,528,530,533,536,539,541,544,547,550,553],{"class":322,"line":522},9,[320,524,454],{"class":326},[320,526,527],{"class":353}," userId",[320,529,460],{"class":326},[320,531,532],{"class":333}," String",[320,534,535],{"class":337},"(Math.",[320,537,538],{"class":333},"round",[320,540,535],{"class":337},[320,542,543],{"class":333},"random",[320,545,546],{"class":337},"() ",[320,548,549],{"class":326},"*",[320,551,552],{"class":353}," 10_000",[320,554,555],{"class":337},"));\n",[320,557,559,561,563,565,568,571,574],{"class":322,"line":558},10,[320,560,483],{"class":326},[320,562,486],{"class":337},[320,564,489],{"class":333},[320,566,567],{"class":492},"`INSERT INTO users VALUES (${",[320,569,570],{"class":337},"userId",[320,572,573],{"class":492},"}, 'John', 'Doe', '')`",[320,575,496],{"class":337},[320,577,579],{"class":322,"line":578},11,[320,580,472],{"emptyLinePlaceholder":471},[320,582,584],{"class":322,"line":583},12,[320,585,586],{"class":477},"  // Query for users\n",[320,588,590,592,595,598,601,604,607,609,611,614,616,619],{"class":322,"line":589},13,[320,591,454],{"class":326},[320,593,594],{"class":337}," { ",[320,596,597],{"class":353},"rows",[320,599,600],{"class":337}," } ",[320,602,603],{"class":326},"=",[320,605,606],{"class":326}," await",[320,608,486],{"class":337},[320,610,489],{"class":333},[320,612,613],{"class":492},"`SELECT * FROM users WHERE id = ${",[320,615,570],{"class":337},[320,617,618],{"class":492},"}`",[320,620,496],{"class":337},[320,622,624],{"class":322,"line":623},14,[320,625,472],{"emptyLinePlaceholder":471},[320,627,629,632],{"class":322,"line":628},15,[320,630,631],{"class":326},"  return",[320,633,449],{"class":337},[320,635,637],{"class":322,"line":636},16,[320,638,639],{"class":337},"    rows,\n",[320,641,643],{"class":322,"line":642},17,[320,644,645],{"class":337},"  };\n",[320,647,649],{"class":322,"line":648},18,[320,650,651],{"class":337},"});\n",[287,653,67],{"id":654},"configuration",[240,656,657,658,661],{},"You can configure database connections using ",[257,659,660],{},"database"," config:",[307,663,664,760],{},[310,665,667],{"className":312,"code":666,"filename":314,"language":315,"meta":316,"style":316},"export default defineNitroConfig({\n  database: {\n    default: {\n      connector: 'sqlite',\n      options: { name: 'db' }\n    },\n    users: {\n      connector: 'postgresql',\n      options: {\n        url: 'postgresql://username:password@hostname:port/database_name'\n      }\n    }\n  }\n})\n",[257,668,669,679,684,689,700,711,716,721,730,735,743,748,752,756],{"__ignoreMap":316},[320,670,671,673,675,677],{"class":322,"line":323},[320,672,327],{"class":326},[320,674,330],{"class":326},[320,676,334],{"class":333},[320,678,338],{"class":337},[320,680,681],{"class":322,"line":341},[320,682,683],{"class":337},"  database: {\n",[320,685,686],{"class":322,"line":347},[320,687,688],{"class":337},"    default: {\n",[320,690,691,694,697],{"class":322,"line":357},[320,692,693],{"class":337},"      connector: ",[320,695,696],{"class":492},"'sqlite'",[320,698,699],{"class":337},",\n",[320,701,702,705,708],{"class":322,"line":363},[320,703,704],{"class":337},"      options: { name: ",[320,706,707],{"class":492},"'db'",[320,709,710],{"class":337}," }\n",[320,712,713],{"class":322,"line":408},[320,714,715],{"class":337},"    },\n",[320,717,718],{"class":322,"line":413},[320,719,720],{"class":337},"    users: {\n",[320,722,723,725,728],{"class":322,"line":516},[320,724,693],{"class":337},[320,726,727],{"class":492},"'postgresql'",[320,729,699],{"class":337},[320,731,732],{"class":322,"line":522},[320,733,734],{"class":337},"      options: {\n",[320,736,737,740],{"class":322,"line":558},[320,738,739],{"class":337},"        url: ",[320,741,742],{"class":492},"'postgresql://username:password@hostname:port/database_name'\n",[320,744,745],{"class":322,"line":578},[320,746,747],{"class":337},"      }\n",[320,749,750],{"class":322,"line":583},[320,751,405],{"class":337},[320,753,754],{"class":322,"line":589},[320,755,360],{"class":337},[320,757,758],{"class":322,"line":623},[320,759,366],{"class":337},[310,761,763],{"className":312,"code":762,"filename":370,"language":315,"meta":316,"style":316},"export default defineNuxtConfig({\n  nitro: {\n    database: {\n      default: {\n        connector: 'sqlite',\n        options: { name: 'db' }\n      },\n      users: {\n        connector: 'postgresql',\n        options: {\n          url: 'postgresql://username:password@hostname:port/database_name'\n        }\n      }\n    }\n  }\n})\n",[257,764,765,775,779,784,789,798,807,812,817,825,830,837,842,846,850,854],{"__ignoreMap":316},[320,766,767,769,771,773],{"class":322,"line":323},[320,768,327],{"class":326},[320,770,330],{"class":326},[320,772,381],{"class":333},[320,774,338],{"class":337},[320,776,777],{"class":322,"line":341},[320,778,388],{"class":337},[320,780,781],{"class":322,"line":347},[320,782,783],{"class":337},"    database: {\n",[320,785,786],{"class":322,"line":357},[320,787,788],{"class":337},"      default: {\n",[320,790,791,794,796],{"class":322,"line":363},[320,792,793],{"class":337},"        connector: ",[320,795,696],{"class":492},[320,797,699],{"class":337},[320,799,800,803,805],{"class":322,"line":408},[320,801,802],{"class":337},"        options: { name: ",[320,804,707],{"class":492},[320,806,710],{"class":337},[320,808,809],{"class":322,"line":413},[320,810,811],{"class":337},"      },\n",[320,813,814],{"class":322,"line":516},[320,815,816],{"class":337},"      users: {\n",[320,818,819,821,823],{"class":322,"line":522},[320,820,793],{"class":337},[320,822,727],{"class":492},[320,824,699],{"class":337},[320,826,827],{"class":322,"line":558},[320,828,829],{"class":337},"        options: {\n",[320,831,832,835],{"class":322,"line":578},[320,833,834],{"class":337},"          url: ",[320,836,742],{"class":492},[320,838,839],{"class":322,"line":583},[320,840,841],{"class":337},"        }\n",[320,843,844],{"class":322,"line":589},[320,845,747],{"class":337},[320,847,848],{"class":322,"line":623},[320,849,405],{"class":337},[320,851,852],{"class":322,"line":628},[320,853,360],{"class":337},[320,855,856],{"class":322,"line":636},[320,857,366],{"class":337},[262,859,860],{},[240,861,862,863,866],{},"\nYou can use the ",[257,864,865],{},"devDatabase","  config to overwrite the database configuration only for development mode.",[868,869,870],"style",{},"html pre.shiki code .so5gQ, html code.shiki .so5gQ{--shiki-light:#D73A49;--shiki-default:#F97583;--shiki-dark:#F97583}html pre.shiki code .shcOC, html code.shiki .shcOC{--shiki-light:#6F42C1;--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .slsVL, html code.shiki .slsVL{--shiki-light:#24292E;--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}html pre.shiki code .suiK_, html code.shiki .suiK_{--shiki-light:#005CC5;--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sfrk1, html code.shiki .sfrk1{--shiki-light:#032F62;--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}",{"title":316,"searchDepth":341,"depth":341,"links":872},[873,874,875],{"id":289,"depth":341,"text":290},{"id":418,"depth":341,"text":419},{"id":654,"depth":341,"text":67},"Nitro provides a built-in and lightweight SQL database layer.","md",{"automd":471,"icon":45},{"icon":45},{"title":42,"description":876},"ANbuEvvYwOWTh_MHQDw1FC-r4k_Ilzd1rSqMQJjnU28",[883,885],{"title":37,"path":38,"stem":39,"description":884,"icon":40,"children":-1},"Nitro provides a built-in storage layer that can abstract filesystem or database or any other data source.",{"title":47,"path":48,"stem":49,"description":886,"icon":50,"children":-1},"Nitro provides a caching system built on top of the storage layer.",1778145697625]