1 /* 2 ** 2003 April 6 3 ** 4 ** The author disclaims copyright to this source code. In place of 5 ** a legal notice, here is a blessing: 6 ** 7 ** May you do good and not evil. 8 ** May you find forgiveness for yourself and forgive others. 9 ** May you share freely, never taking more than you give. 10 ** 11 ************************************************************************* 12 ** This file contains code used to implement the ATTACH and DETACH commands. 13 */ 14 #include "sqliteInt.h" 15 16 #ifndef SQLITE_OMIT_ATTACH 17 /* 18 ** Resolve an expression that was part of an ATTACH or DETACH statement. This 19 ** is slightly different from resolving a normal SQL expression, because simple 20 ** identifiers are treated as strings, not possible column names or aliases. 21 ** 22 ** i.e. if the parser sees: 23 ** 24 ** ATTACH DATABASE abc AS def 25 ** 26 ** it treats the two expressions as literal strings 'abc' and 'def' instead of 27 ** looking for columns of the same name. 28 ** 29 ** This only applies to the root node of pExpr, so the statement: 30 ** 31 ** ATTACH DATABASE abc||def AS 'db2' 32 ** 33 ** will fail because neither abc or def can be resolved. 34 */ 35 static int resolveAttachExpr(NameContext *pName, Expr *pExpr) 36 { 37 int rc = SQLITE_OK; 38 if( pExpr ){ 39 if( pExpr->op!=TK_ID ){ 40 rc = sqlite3ResolveExprNames(pName, pExpr); 41 }else{ 42 pExpr->op = TK_STRING; 43 } 44 } 45 return rc; 46 } 47 48 /* 49 ** An SQL user-function registered to do the work of an ATTACH statement. The 50 ** three arguments to the function come directly from an attach statement: 51 ** 52 ** ATTACH DATABASE x AS y KEY z 53 ** 54 ** SELECT sqlite_attach(x, y, z) 55 ** 56 ** If the optional "KEY z" syntax is omitted, an SQL NULL is passed as the 57 ** third argument. 58 */ 59 static void attachFunc( 60 sqlite3_context *context, 61 int NotUsed, 62 sqlite3_value **argv 63 ){ 64 int i; 65 int rc = 0; 66 sqlite3 *db = sqlite3_context_db_handle(context); 67 const char *zName; 68 const char *zFile; 69 char *zPath = 0; 70 char *zErr = 0; 71 unsigned int flags; 72 Db *aNew; 73 char *zErrDyn = 0; 74 sqlite3_vfs *pVfs; 75 76 UNUSED_PARAMETER(NotUsed); 77 78 zFile = (const char *)sqlite3_value_text(argv[0]); 79 zName = (const char *)sqlite3_value_text(argv[1]); 80 if( zFile==0 ) zFile = ""; 81 if( zName==0 ) zName = ""; 82 83 /* Check for the following errors: 84 ** 85 ** * Too many attached databases, 86 ** * Transaction currently open 87 ** * Specified database name already being used. 88 */ 89 if( db->nDb>=db->aLimit[SQLITE_LIMIT_ATTACHED]+2 ){ 90 zErrDyn = sqlite3MPrintf(db, "too many attached databases - max %d", 91 db->aLimit[SQLITE_LIMIT_ATTACHED] 92 ); 93 goto attach_error; 94 } 95 if( !db->autoCommit ){ 96 zErrDyn = sqlite3MPrintf(db, "cannot ATTACH database within transaction"); 97 goto attach_error; 98 } 99 for(i=0; i<db->nDb; i++){ 100 char *z = db->aDb[i].zName; 101 assert( z && zName ); 102 if( sqlite3StrICmp(z, zName)==0 ){ 103 zErrDyn = sqlite3MPrintf(db, "database %s is already in use", zName); 104 goto attach_error; 105 } 106 } 107 108 /* Allocate the new entry in the db->aDb[] array and initialize the schema 109 ** hash tables. 110 */ 111 if( db->aDb==db->aDbStatic ){ 112 aNew = sqlite3DbMallocRaw(db, sizeof(db->aDb[0])*3 ); 113 if( aNew==0 ) return; 114 memcpy(aNew, db->aDb, sizeof(db->aDb[0])*2); 115 }else{ 116 aNew = sqlite3DbRealloc(db, db->aDb, sizeof(db->aDb[0])*(db->nDb+1) ); 117 if( aNew==0 ) return; 118 } 119 db->aDb = aNew; 120 aNew = &db->aDb[db->nDb]; 121 memset(aNew, 0, sizeof(*aNew)); 122 123 /* Open the database file. If the btree is successfully opened, use 124 ** it to obtain the database schema. At this point the schema may 125 ** or may not be initialized. 126 */ 127 flags = db->openFlags; 128 rc = sqlite3ParseUri(db->pVfs->zName, zFile, &flags, &pVfs, &zPath, &zErr); 129 if( rc!=SQLITE_OK ){ 130 if( rc==SQLITE_NOMEM ) db->mallocFailed = 1; 131 sqlite3_result_error(context, zErr, -1); 132 sqlite3_free(zErr); 133 return; 134 } 135 assert( pVfs ); 136 flags |= SQLITE_OPEN_MAIN_DB; 137 rc = sqlite3BtreeOpen(pVfs, zPath, db, &aNew->pBt, 0, flags); 138 sqlite3_free( zPath ); 139 db->nDb++; 140 if( rc==SQLITE_CONSTRAINT ){ 141 rc = SQLITE_ERROR; 142 zErrDyn = sqlite3MPrintf(db, "database is already attached"); 143 }else if( rc==SQLITE_OK ){ 144 Pager *pPager; 145 aNew->pSchema = sqlite3SchemaGet(db, aNew->pBt); 146 if( !aNew->pSchema ){ 147 rc = SQLITE_NOMEM; 148 }else if( aNew->pSchema->file_format && aNew->pSchema->enc!=ENC(db) ){ 149 zErrDyn = sqlite3MPrintf(db, 150 "attached databases must use the same text encoding as main database"); 151 rc = SQLITE_ERROR; 152 } 153 sqlite3BtreeEnter(aNew->pBt); 154 pPager = sqlite3BtreePager(aNew->pBt); 155 sqlite3PagerLockingMode(pPager, db->dfltLockMode); 156 sqlite3BtreeSecureDelete(aNew->pBt, 157 sqlite3BtreeSecureDelete(db->aDb[0].pBt,-1) ); 158 #ifndef SQLITE_OMIT_PAGER_PRAGMAS 159 sqlite3BtreeSetPagerFlags(aNew->pBt, 3 | (db->flags & PAGER_FLAGS_MASK)); 160 #endif 161 sqlite3BtreeLeave(aNew->pBt); 162 } 163 aNew->safety_level = 3; 164 aNew->zName = sqlite3DbStrDup(db, zName); 165 if( rc==SQLITE_OK && aNew->zName==0 ){ 166 rc = SQLITE_NOMEM; 167 } 168 169 170 #ifdef SQLITE_HAS_CODEC 171 if( rc==SQLITE_OK ){ 172 extern int sqlite3CodecAttach(sqlite3*, int, const void*, int); 173 extern void sqlite3CodecGetKey(sqlite3*, int, void**, int*); 174 int nKey; 175 char *zKey; 176 int t = sqlite3_value_type(argv[2]); 177 switch( t ){ 178 case SQLITE_INTEGER: 179 case SQLITE_FLOAT: 180 zErrDyn = sqlite3DbStrDup(db, "Invalid key value"); 181 rc = SQLITE_ERROR; 182 break; 183 184 case SQLITE_TEXT: 185 case SQLITE_BLOB: 186 nKey = sqlite3_value_bytes(argv[2]); 187 zKey = (char *)sqlite3_value_blob(argv[2]); 188 rc = sqlite3CodecAttach(db, db->nDb-1, zKey, nKey); 189 break; 190 191 case SQLITE_NULL: 192 /* No key specified. Use the key from the main database */ 193 sqlite3CodecGetKey(db, 0, (void**)&zKey, &nKey); 194 if( nKey>0 || sqlite3BtreeGetOptimalReserve(db->aDb[0].pBt)>0 ){ 195 rc = sqlite3CodecAttach(db, db->nDb-1, zKey, nKey); 196 } 197 break; 198 } 199 } 200 #endif 201 202 /* If the file was opened successfully, read the schema for the new database. 203 ** If this fails, or if opening the file failed, then close the file and 204 ** remove the entry from the db->aDb[] array. i.e. put everything back the way 205 ** we found it. 206 */ 207 if( rc==SQLITE_OK ){ 208 sqlite3BtreeEnterAll(db); 209 rc = sqlite3Init(db, &zErrDyn); 210 sqlite3BtreeLeaveAll(db); 211 } 212 #ifdef SQLITE_USER_AUTHENTICATION 213 if( rc==SQLITE_OK ){ 214 u8 newAuth = 0; 215 rc = sqlite3UserAuthCheckLogin(db, zName, &newAuth); 216 if( newAuth<db->auth.authLevel ){ 217 rc = SQLITE_AUTH_USER; 218 } 219 } 220 #endif 221 if( rc ){ 222 int iDb = db->nDb - 1; 223 assert( iDb>=2 ); 224 if( db->aDb[iDb].pBt ){ 225 sqlite3BtreeClose(db->aDb[iDb].pBt); 226 db->aDb[iDb].pBt = 0; 227 db->aDb[iDb].pSchema = 0; 228 } 229 sqlite3ResetAllSchemasOfConnection(db); 230 db->nDb = iDb; 231 if( rc==SQLITE_NOMEM || rc==SQLITE_IOERR_NOMEM ){ 232 db->mallocFailed = 1; 233 sqlite3DbFree(db, zErrDyn); 234 zErrDyn = sqlite3MPrintf(db, "out of memory"); 235 }else if( zErrDyn==0 ){ 236 zErrDyn = sqlite3MPrintf(db, "unable to open database: %s", zFile); 237 } 238 goto attach_error; 239 } 240 241 return; 242 243 attach_error: 244 /* Return an error if we get here */ 245 if( zErrDyn ){ 246 sqlite3_result_error(context, zErrDyn, -1); 247 sqlite3DbFree(db, zErrDyn); 248 } 249 if( rc ) sqlite3_result_error_code(context, rc); 250 } 251 252 /* 253 ** An SQL user-function registered to do the work of an DETACH statement. The 254 ** three arguments to the function come directly from a detach statement: 255 ** 256 ** DETACH DATABASE x 257 ** 258 ** SELECT sqlite_detach(x) 259 */ 260 static void detachFunc( 261 sqlite3_context *context, 262 int NotUsed, 263 sqlite3_value **argv 264 ){ 265 const char *zName = (const char *)sqlite3_value_text(argv[0]); 266 sqlite3 *db = sqlite3_context_db_handle(context); 267 int i; 268 Db *pDb = 0; 269 char zErr[128]; 270 271 UNUSED_PARAMETER(NotUsed); 272 273 if( zName==0 ) zName = ""; 274 for(i=0; i<db->nDb; i++){ 275 pDb = &db->aDb[i]; 276 if( pDb->pBt==0 ) continue; 277 if( sqlite3StrICmp(pDb->zName, zName)==0 ) break; 278 } 279 280 if( i>=db->nDb ){ 281 sqlite3_snprintf(sizeof(zErr),zErr, "no such database: %s", zName); 282 goto detach_error; 283 } 284 if( i<2 ){ 285 sqlite3_snprintf(sizeof(zErr),zErr, "cannot detach database %s", zName); 286 goto detach_error; 287 } 288 if( !db->autoCommit ){ 289 sqlite3_snprintf(sizeof(zErr), zErr, 290 "cannot DETACH database within transaction"); 291 goto detach_error; 292 } 293 if( sqlite3BtreeIsInReadTrans(pDb->pBt) || sqlite3BtreeIsInBackup(pDb->pBt) ){ 294 sqlite3_snprintf(sizeof(zErr),zErr, "database %s is locked", zName); 295 goto detach_error; 296 } 297 298 sqlite3BtreeClose(pDb->pBt); 299 pDb->pBt = 0; 300 pDb->pSchema = 0; 301 sqlite3ResetAllSchemasOfConnection(db); 302 return; 303 304 detach_error: 305 sqlite3_result_error(context, zErr, -1); 306 } 307 308 /* 309 ** This procedure generates VDBE code for a single invocation of either the 310 ** sqlite_detach() or sqlite_attach() SQL user functions. 311 */ 312 static void codeAttach( 313 Parse *pParse, /* The parser context */ 314 int type, /* Either SQLITE_ATTACH or SQLITE_DETACH */ 315 FuncDef const *pFunc,/* FuncDef wrapper for detachFunc() or attachFunc() */ 316 Expr *pAuthArg, /* Expression to pass to authorization callback */ 317 Expr *pFilename, /* Name of database file */ 318 Expr *pDbname, /* Name of the database to use internally */ 319 Expr *pKey /* Database key for encryption extension */ 320 ){ 321 int rc; 322 NameContext sName; 323 Vdbe *v; 324 sqlite3* db = pParse->db; 325 int regArgs; 326 327 memset(&sName, 0, sizeof(NameContext)); 328 sName.pParse = pParse; 329 330 if( 331 SQLITE_OK!=(rc = resolveAttachExpr(&sName, pFilename)) || 332 SQLITE_OK!=(rc = resolveAttachExpr(&sName, pDbname)) || 333 SQLITE_OK!=(rc = resolveAttachExpr(&sName, pKey)) 334 ){ 335 pParse->nErr++; 336 goto attach_end; 337 } 338 339 #ifndef SQLITE_OMIT_AUTHORIZATION 340 if( pAuthArg ){ 341 char *zAuthArg; 342 if( pAuthArg->op==TK_STRING ){ 343 zAuthArg = pAuthArg->u.zToken; 344 }else{ 345 zAuthArg = 0; 346 } 347 rc = sqlite3AuthCheck(pParse, type, zAuthArg, 0, 0); 348 if(rc!=SQLITE_OK ){ 349 goto attach_end; 350 } 351 } 352 #endif /* SQLITE_OMIT_AUTHORIZATION */ 353 354 355 v = sqlite3GetVdbe(pParse); 356 regArgs = sqlite3GetTempRange(pParse, 4); 357 sqlite3ExprCode(pParse, pFilename, regArgs); 358 sqlite3ExprCode(pParse, pDbname, regArgs+1); 359 sqlite3ExprCode(pParse, pKey, regArgs+2); 360 361 assert( v || db->mallocFailed ); 362 if( v ){ 363 sqlite3VdbeAddOp3(v, OP_Function, 0, regArgs+3-pFunc->nArg, regArgs+3); 364 assert( pFunc->nArg==-1 || (pFunc->nArg&0xff)==pFunc->nArg ); 365 sqlite3VdbeChangeP5(v, (u8)(pFunc->nArg)); 366 sqlite3VdbeChangeP4(v, -1, (char *)pFunc, P4_FUNCDEF); 367 368 /* Code an OP_Expire. For an ATTACH statement, set P1 to true (expire this 369 ** statement only). For DETACH, set it to false (expire all existing 370 ** statements). 371 */ 372 sqlite3VdbeAddOp1(v, OP_Expire, (type==SQLITE_ATTACH)); 373 } 374 375 attach_end: 376 sqlite3ExprDelete(db, pFilename); 377 sqlite3ExprDelete(db, pDbname); 378 sqlite3ExprDelete(db, pKey); 379 } 380 381 /* 382 ** Called by the parser to compile a DETACH statement. 383 ** 384 ** DETACH pDbname 385 */ 386 void sqlite3Detach(Parse *pParse, Expr *pDbname){ 387 static const FuncDef detach_func = { 388 1, /* nArg */ 389 SQLITE_UTF8, /* funcFlags */ 390 0, /* pUserData */ 391 0, /* pNext */ 392 detachFunc, /* xFunc */ 393 0, /* xStep */ 394 0, /* xFinalize */ 395 "sqlite_detach", /* zName */ 396 0, /* pHash */ 397 0 /* pDestructor */ 398 }; 399 codeAttach(pParse, SQLITE_DETACH, &detach_func, pDbname, 0, 0, pDbname); 400 } 401 402 /* 403 ** Called by the parser to compile an ATTACH statement. 404 ** 405 ** ATTACH p AS pDbname KEY pKey 406 */ 407 void sqlite3Attach(Parse *pParse, Expr *p, Expr *pDbname, Expr *pKey){ 408 static const FuncDef attach_func = { 409 3, /* nArg */ 410 SQLITE_UTF8, /* funcFlags */ 411 0, /* pUserData */ 412 0, /* pNext */ 413 attachFunc, /* xFunc */ 414 0, /* xStep */ 415 0, /* xFinalize */ 416 "sqlite_attach", /* zName */ 417 0, /* pHash */ 418 0 /* pDestructor */ 419 }; 420 codeAttach(pParse, SQLITE_ATTACH, &attach_func, p, p, pDbname, pKey); 421 } 422 #endif /* SQLITE_OMIT_ATTACH */ 423 424 /* 425 ** Initialize a DbFixer structure. This routine must be called prior 426 ** to passing the structure to one of the sqliteFixAAAA() routines below. 427 */ 428 void sqlite3FixInit( 429 DbFixer *pFix, /* The fixer to be initialized */ 430 Parse *pParse, /* Error messages will be written here */ 431 int iDb, /* This is the database that must be used */ 432 const char *zType, /* "view", "trigger", or "index" */ 433 const Token *pName /* Name of the view, trigger, or index */ 434 ){ 435 sqlite3 *db; 436 437 db = pParse->db; 438 assert( db->nDb>iDb ); 439 pFix->pParse = pParse; 440 pFix->zDb = db->aDb[iDb].zName; 441 pFix->pSchema = db->aDb[iDb].pSchema; 442 pFix->zType = zType; 443 pFix->pName = pName; 444 pFix->bVarOnly = (iDb==1); 445 } 446 447 /* 448 ** The following set of routines walk through the parse tree and assign 449 ** a specific database to all table references where the database name 450 ** was left unspecified in the original SQL statement. The pFix structure 451 ** must have been initialized by a prior call to sqlite3FixInit(). 452 ** 453 ** These routines are used to make sure that an index, trigger, or 454 ** view in one database does not refer to objects in a different database. 455 ** (Exception: indices, triggers, and views in the TEMP database are 456 ** allowed to refer to anything.) If a reference is explicitly made 457 ** to an object in a different database, an error message is added to 458 ** pParse->zErrMsg and these routines return non-zero. If everything 459 ** checks out, these routines return 0. 460 */ 461 int sqlite3FixSrcList( 462 DbFixer *pFix, /* Context of the fixation */ 463 SrcList *pList /* The Source list to check and modify */ 464 ){ 465 int i; 466 const char *zDb; 467 struct SrcList_item *pItem; 468 469 if( NEVER(pList==0) ) return 0; 470 zDb = pFix->zDb; 471 for(i=0, pItem=pList->a; i<pList->nSrc; i++, pItem++){ 472 if( pFix->bVarOnly==0 ){ 473 if( pItem->zDatabase && sqlite3StrICmp(pItem->zDatabase, zDb) ){ 474 sqlite3ErrorMsg(pFix->pParse, 475 "%s %T cannot reference objects in database %s", 476 pFix->zType, pFix->pName, pItem->zDatabase); 477 return 1; 478 } 479 sqlite3DbFree(pFix->pParse->db, pItem->zDatabase); 480 pItem->zDatabase = 0; 481 pItem->pSchema = pFix->pSchema; 482 } 483 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) 484 if( sqlite3FixSelect(pFix, pItem->pSelect) ) return 1; 485 if( sqlite3FixExpr(pFix, pItem->pOn) ) return 1; 486 #endif 487 } 488 return 0; 489 } 490 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER) 491 int sqlite3FixSelect( 492 DbFixer *pFix, /* Context of the fixation */ 493 Select *pSelect /* The SELECT statement to be fixed to one database */ 494 ){ 495 while( pSelect ){ 496 if( sqlite3FixExprList(pFix, pSelect->pEList) ){ 497 return 1; 498 } 499 if( sqlite3FixSrcList(pFix, pSelect->pSrc) ){ 500 return 1; 501 } 502 if( sqlite3FixExpr(pFix, pSelect->pWhere) ){ 503 return 1; 504 } 505 if( sqlite3FixExprList(pFix, pSelect->pGroupBy) ){ 506 return 1; 507 } 508 if( sqlite3FixExpr(pFix, pSelect->pHaving) ){ 509 return 1; 510 } 511 if( sqlite3FixExprList(pFix, pSelect->pOrderBy) ){ 512 return 1; 513 } 514 if( sqlite3FixExpr(pFix, pSelect->pLimit) ){ 515 return 1; 516 } 517 if( sqlite3FixExpr(pFix, pSelect->pOffset) ){ 518 return 1; 519 } 520 pSelect = pSelect->pPrior; 521 } 522 return 0; 523 } 524 int sqlite3FixExpr( 525 DbFixer *pFix, /* Context of the fixation */ 526 Expr *pExpr /* The expression to be fixed to one database */ 527 ){ 528 while( pExpr ){ 529 if( pExpr->op==TK_VARIABLE ){ 530 if( pFix->pParse->db->init.busy ){ 531 pExpr->op = TK_NULL; 532 }else{ 533 sqlite3ErrorMsg(pFix->pParse, "%s cannot use variables", pFix->zType); 534 return 1; 535 } 536 } 537 if( ExprHasProperty(pExpr, EP_TokenOnly) ) break; 538 if( ExprHasProperty(pExpr, EP_xIsSelect) ){ 539 if( sqlite3FixSelect(pFix, pExpr->x.pSelect) ) return 1; 540 }else{ 541 if( sqlite3FixExprList(pFix, pExpr->x.pList) ) return 1; 542 } 543 if( sqlite3FixExpr(pFix, pExpr->pRight) ){ 544 return 1; 545 } 546 pExpr = pExpr->pLeft; 547 } 548 return 0; 549 } 550 int sqlite3FixExprList( 551 DbFixer *pFix, /* Context of the fixation */ 552 ExprList *pList /* The expression to be fixed to one database */ 553 ){ 554 int i; 555 struct ExprList_item *pItem; 556 if( pList==0 ) return 0; 557 for(i=0, pItem=pList->a; i<pList->nExpr; i++, pItem++){ 558 if( sqlite3FixExpr(pFix, pItem->pExpr) ){ 559 return 1; 560 } 561 } 562 return 0; 563 } 564 #endif 565 566 #ifndef SQLITE_OMIT_TRIGGER 567 int sqlite3FixTriggerStep( 568 DbFixer *pFix, /* Context of the fixation */ 569 TriggerStep *pStep /* The trigger step be fixed to one database */ 570 ){ 571 while( pStep ){ 572 if( sqlite3FixSelect(pFix, pStep->pSelect) ){ 573 return 1; 574 } 575 if( sqlite3FixExpr(pFix, pStep->pWhere) ){ 576 return 1; 577 } 578 if( sqlite3FixExprList(pFix, pStep->pExprList) ){ 579 return 1; 580 } 581 pStep = pStep->pNext; 582 } 583 return 0; 584 } 585 #endif 586