xref: /sqlite-3.40.0/src/attach.c (revision bd41d566)
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 || sqlite3BtreeGetReserve(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