xref: /sqlite-3.40.0/src/attach.c (revision a3fdec71)
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     pPager = sqlite3BtreePager(aNew->pBt);
154     sqlite3PagerLockingMode(pPager, db->dfltLockMode);
155     sqlite3BtreeSecureDelete(aNew->pBt,
156                              sqlite3BtreeSecureDelete(db->aDb[0].pBt,-1) );
157 #ifndef SQLITE_OMIT_PAGER_PRAGMAS
158     sqlite3BtreeSetPagerFlags(aNew->pBt, 3 | (db->flags & PAGER_FLAGS_MASK));
159 #endif
160   }
161   aNew->safety_level = 3;
162   aNew->zName = sqlite3DbStrDup(db, zName);
163   if( rc==SQLITE_OK && aNew->zName==0 ){
164     rc = SQLITE_NOMEM;
165   }
166 
167 
168 #ifdef SQLITE_HAS_CODEC
169   if( rc==SQLITE_OK ){
170     extern int sqlite3CodecAttach(sqlite3*, int, const void*, int);
171     extern void sqlite3CodecGetKey(sqlite3*, int, void**, int*);
172     int nKey;
173     char *zKey;
174     int t = sqlite3_value_type(argv[2]);
175     switch( t ){
176       case SQLITE_INTEGER:
177       case SQLITE_FLOAT:
178         zErrDyn = sqlite3DbStrDup(db, "Invalid key value");
179         rc = SQLITE_ERROR;
180         break;
181 
182       case SQLITE_TEXT:
183       case SQLITE_BLOB:
184         nKey = sqlite3_value_bytes(argv[2]);
185         zKey = (char *)sqlite3_value_blob(argv[2]);
186         rc = sqlite3CodecAttach(db, db->nDb-1, zKey, nKey);
187         break;
188 
189       case SQLITE_NULL:
190         /* No key specified.  Use the key from the main database */
191         sqlite3CodecGetKey(db, 0, (void**)&zKey, &nKey);
192         if( nKey>0 || sqlite3BtreeGetReserve(db->aDb[0].pBt)>0 ){
193           rc = sqlite3CodecAttach(db, db->nDb-1, zKey, nKey);
194         }
195         break;
196     }
197   }
198 #endif
199 
200   /* If the file was opened successfully, read the schema for the new database.
201   ** If this fails, or if opening the file failed, then close the file and
202   ** remove the entry from the db->aDb[] array. i.e. put everything back the way
203   ** we found it.
204   */
205   if( rc==SQLITE_OK ){
206     sqlite3BtreeEnterAll(db);
207     rc = sqlite3Init(db, &zErrDyn);
208     sqlite3BtreeLeaveAll(db);
209   }
210   if( rc ){
211     int iDb = db->nDb - 1;
212     assert( iDb>=2 );
213     if( db->aDb[iDb].pBt ){
214       sqlite3BtreeClose(db->aDb[iDb].pBt);
215       db->aDb[iDb].pBt = 0;
216       db->aDb[iDb].pSchema = 0;
217     }
218     sqlite3ResetAllSchemasOfConnection(db);
219     db->nDb = iDb;
220     if( rc==SQLITE_NOMEM || rc==SQLITE_IOERR_NOMEM ){
221       db->mallocFailed = 1;
222       sqlite3DbFree(db, zErrDyn);
223       zErrDyn = sqlite3MPrintf(db, "out of memory");
224     }else if( zErrDyn==0 ){
225       zErrDyn = sqlite3MPrintf(db, "unable to open database: %s", zFile);
226     }
227     goto attach_error;
228   }
229 
230   return;
231 
232 attach_error:
233   /* Return an error if we get here */
234   if( zErrDyn ){
235     sqlite3_result_error(context, zErrDyn, -1);
236     sqlite3DbFree(db, zErrDyn);
237   }
238   if( rc ) sqlite3_result_error_code(context, rc);
239 }
240 
241 /*
242 ** An SQL user-function registered to do the work of an DETACH statement. The
243 ** three arguments to the function come directly from a detach statement:
244 **
245 **     DETACH DATABASE x
246 **
247 **     SELECT sqlite_detach(x)
248 */
249 static void detachFunc(
250   sqlite3_context *context,
251   int NotUsed,
252   sqlite3_value **argv
253 ){
254   const char *zName = (const char *)sqlite3_value_text(argv[0]);
255   sqlite3 *db = sqlite3_context_db_handle(context);
256   int i;
257   Db *pDb = 0;
258   char zErr[128];
259 
260   UNUSED_PARAMETER(NotUsed);
261 
262   if( zName==0 ) zName = "";
263   for(i=0; i<db->nDb; i++){
264     pDb = &db->aDb[i];
265     if( pDb->pBt==0 ) continue;
266     if( sqlite3StrICmp(pDb->zName, zName)==0 ) break;
267   }
268 
269   if( i>=db->nDb ){
270     sqlite3_snprintf(sizeof(zErr),zErr, "no such database: %s", zName);
271     goto detach_error;
272   }
273   if( i<2 ){
274     sqlite3_snprintf(sizeof(zErr),zErr, "cannot detach database %s", zName);
275     goto detach_error;
276   }
277   if( !db->autoCommit ){
278     sqlite3_snprintf(sizeof(zErr), zErr,
279                      "cannot DETACH database within transaction");
280     goto detach_error;
281   }
282   if( sqlite3BtreeIsInReadTrans(pDb->pBt) || sqlite3BtreeIsInBackup(pDb->pBt) ){
283     sqlite3_snprintf(sizeof(zErr),zErr, "database %s is locked", zName);
284     goto detach_error;
285   }
286 
287   sqlite3BtreeClose(pDb->pBt);
288   pDb->pBt = 0;
289   pDb->pSchema = 0;
290   sqlite3ResetAllSchemasOfConnection(db);
291   return;
292 
293 detach_error:
294   sqlite3_result_error(context, zErr, -1);
295 }
296 
297 /*
298 ** This procedure generates VDBE code for a single invocation of either the
299 ** sqlite_detach() or sqlite_attach() SQL user functions.
300 */
301 static void codeAttach(
302   Parse *pParse,       /* The parser context */
303   int type,            /* Either SQLITE_ATTACH or SQLITE_DETACH */
304   FuncDef const *pFunc,/* FuncDef wrapper for detachFunc() or attachFunc() */
305   Expr *pAuthArg,      /* Expression to pass to authorization callback */
306   Expr *pFilename,     /* Name of database file */
307   Expr *pDbname,       /* Name of the database to use internally */
308   Expr *pKey           /* Database key for encryption extension */
309 ){
310   int rc;
311   NameContext sName;
312   Vdbe *v;
313   sqlite3* db = pParse->db;
314   int regArgs;
315 
316   memset(&sName, 0, sizeof(NameContext));
317   sName.pParse = pParse;
318 
319   if(
320       SQLITE_OK!=(rc = resolveAttachExpr(&sName, pFilename)) ||
321       SQLITE_OK!=(rc = resolveAttachExpr(&sName, pDbname)) ||
322       SQLITE_OK!=(rc = resolveAttachExpr(&sName, pKey))
323   ){
324     pParse->nErr++;
325     goto attach_end;
326   }
327 
328 #ifndef SQLITE_OMIT_AUTHORIZATION
329   if( pAuthArg ){
330     char *zAuthArg;
331     if( pAuthArg->op==TK_STRING ){
332       zAuthArg = pAuthArg->u.zToken;
333     }else{
334       zAuthArg = 0;
335     }
336     rc = sqlite3AuthCheck(pParse, type, zAuthArg, 0, 0);
337     if(rc!=SQLITE_OK ){
338       goto attach_end;
339     }
340   }
341 #endif /* SQLITE_OMIT_AUTHORIZATION */
342 
343 
344   v = sqlite3GetVdbe(pParse);
345   regArgs = sqlite3GetTempRange(pParse, 4);
346   sqlite3ExprCode(pParse, pFilename, regArgs);
347   sqlite3ExprCode(pParse, pDbname, regArgs+1);
348   sqlite3ExprCode(pParse, pKey, regArgs+2);
349 
350   assert( v || db->mallocFailed );
351   if( v ){
352     sqlite3VdbeAddOp3(v, OP_Function, 0, regArgs+3-pFunc->nArg, regArgs+3);
353     assert( pFunc->nArg==-1 || (pFunc->nArg&0xff)==pFunc->nArg );
354     sqlite3VdbeChangeP5(v, (u8)(pFunc->nArg));
355     sqlite3VdbeChangeP4(v, -1, (char *)pFunc, P4_FUNCDEF);
356 
357     /* Code an OP_Expire. For an ATTACH statement, set P1 to true (expire this
358     ** statement only). For DETACH, set it to false (expire all existing
359     ** statements).
360     */
361     sqlite3VdbeAddOp1(v, OP_Expire, (type==SQLITE_ATTACH));
362   }
363 
364 attach_end:
365   sqlite3ExprDelete(db, pFilename);
366   sqlite3ExprDelete(db, pDbname);
367   sqlite3ExprDelete(db, pKey);
368 }
369 
370 /*
371 ** Called by the parser to compile a DETACH statement.
372 **
373 **     DETACH pDbname
374 */
375 void sqlite3Detach(Parse *pParse, Expr *pDbname){
376   static const FuncDef detach_func = {
377     1,                /* nArg */
378     SQLITE_UTF8,      /* funcFlags */
379     0,                /* pUserData */
380     0,                /* pNext */
381     detachFunc,       /* xFunc */
382     0,                /* xStep */
383     0,                /* xFinalize */
384     "sqlite_detach",  /* zName */
385     0,                /* pHash */
386     0                 /* pDestructor */
387   };
388   codeAttach(pParse, SQLITE_DETACH, &detach_func, pDbname, 0, 0, pDbname);
389 }
390 
391 /*
392 ** Called by the parser to compile an ATTACH statement.
393 **
394 **     ATTACH p AS pDbname KEY pKey
395 */
396 void sqlite3Attach(Parse *pParse, Expr *p, Expr *pDbname, Expr *pKey){
397   static const FuncDef attach_func = {
398     3,                /* nArg */
399     SQLITE_UTF8,      /* funcFlags */
400     0,                /* pUserData */
401     0,                /* pNext */
402     attachFunc,       /* xFunc */
403     0,                /* xStep */
404     0,                /* xFinalize */
405     "sqlite_attach",  /* zName */
406     0,                /* pHash */
407     0                 /* pDestructor */
408   };
409   codeAttach(pParse, SQLITE_ATTACH, &attach_func, p, p, pDbname, pKey);
410 }
411 #endif /* SQLITE_OMIT_ATTACH */
412 
413 /*
414 ** Initialize a DbFixer structure.  This routine must be called prior
415 ** to passing the structure to one of the sqliteFixAAAA() routines below.
416 */
417 void sqlite3FixInit(
418   DbFixer *pFix,      /* The fixer to be initialized */
419   Parse *pParse,      /* Error messages will be written here */
420   int iDb,            /* This is the database that must be used */
421   const char *zType,  /* "view", "trigger", or "index" */
422   const Token *pName  /* Name of the view, trigger, or index */
423 ){
424   sqlite3 *db;
425 
426   db = pParse->db;
427   assert( db->nDb>iDb );
428   pFix->pParse = pParse;
429   pFix->zDb = db->aDb[iDb].zName;
430   pFix->pSchema = db->aDb[iDb].pSchema;
431   pFix->zType = zType;
432   pFix->pName = pName;
433   pFix->bVarOnly = (iDb==1);
434 }
435 
436 /*
437 ** The following set of routines walk through the parse tree and assign
438 ** a specific database to all table references where the database name
439 ** was left unspecified in the original SQL statement.  The pFix structure
440 ** must have been initialized by a prior call to sqlite3FixInit().
441 **
442 ** These routines are used to make sure that an index, trigger, or
443 ** view in one database does not refer to objects in a different database.
444 ** (Exception: indices, triggers, and views in the TEMP database are
445 ** allowed to refer to anything.)  If a reference is explicitly made
446 ** to an object in a different database, an error message is added to
447 ** pParse->zErrMsg and these routines return non-zero.  If everything
448 ** checks out, these routines return 0.
449 */
450 int sqlite3FixSrcList(
451   DbFixer *pFix,       /* Context of the fixation */
452   SrcList *pList       /* The Source list to check and modify */
453 ){
454   int i;
455   const char *zDb;
456   struct SrcList_item *pItem;
457 
458   if( NEVER(pList==0) ) return 0;
459   zDb = pFix->zDb;
460   for(i=0, pItem=pList->a; i<pList->nSrc; i++, pItem++){
461     if( pFix->bVarOnly==0 ){
462       if( pItem->zDatabase && sqlite3StrICmp(pItem->zDatabase, zDb) ){
463         sqlite3ErrorMsg(pFix->pParse,
464             "%s %T cannot reference objects in database %s",
465             pFix->zType, pFix->pName, pItem->zDatabase);
466         return 1;
467       }
468       sqlite3DbFree(pFix->pParse->db, pItem->zDatabase);
469       pItem->zDatabase = 0;
470       pItem->pSchema = pFix->pSchema;
471     }
472 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER)
473     if( sqlite3FixSelect(pFix, pItem->pSelect) ) return 1;
474     if( sqlite3FixExpr(pFix, pItem->pOn) ) return 1;
475 #endif
476   }
477   return 0;
478 }
479 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER)
480 int sqlite3FixSelect(
481   DbFixer *pFix,       /* Context of the fixation */
482   Select *pSelect      /* The SELECT statement to be fixed to one database */
483 ){
484   while( pSelect ){
485     if( sqlite3FixExprList(pFix, pSelect->pEList) ){
486       return 1;
487     }
488     if( sqlite3FixSrcList(pFix, pSelect->pSrc) ){
489       return 1;
490     }
491     if( sqlite3FixExpr(pFix, pSelect->pWhere) ){
492       return 1;
493     }
494     if( sqlite3FixExprList(pFix, pSelect->pGroupBy) ){
495       return 1;
496     }
497     if( sqlite3FixExpr(pFix, pSelect->pHaving) ){
498       return 1;
499     }
500     if( sqlite3FixExprList(pFix, pSelect->pOrderBy) ){
501       return 1;
502     }
503     if( sqlite3FixExpr(pFix, pSelect->pLimit) ){
504       return 1;
505     }
506     if( sqlite3FixExpr(pFix, pSelect->pOffset) ){
507       return 1;
508     }
509     pSelect = pSelect->pPrior;
510   }
511   return 0;
512 }
513 int sqlite3FixExpr(
514   DbFixer *pFix,     /* Context of the fixation */
515   Expr *pExpr        /* The expression to be fixed to one database */
516 ){
517   while( pExpr ){
518     if( pExpr->op==TK_VARIABLE ){
519       if( pFix->pParse->db->init.busy ){
520         pExpr->op = TK_NULL;
521       }else{
522         sqlite3ErrorMsg(pFix->pParse, "%s cannot use variables", pFix->zType);
523         return 1;
524       }
525     }
526     if( ExprHasProperty(pExpr, EP_TokenOnly) ) break;
527     if( ExprHasProperty(pExpr, EP_xIsSelect) ){
528       if( sqlite3FixSelect(pFix, pExpr->x.pSelect) ) return 1;
529     }else{
530       if( sqlite3FixExprList(pFix, pExpr->x.pList) ) return 1;
531     }
532     if( sqlite3FixExpr(pFix, pExpr->pRight) ){
533       return 1;
534     }
535     pExpr = pExpr->pLeft;
536   }
537   return 0;
538 }
539 int sqlite3FixExprList(
540   DbFixer *pFix,     /* Context of the fixation */
541   ExprList *pList    /* The expression to be fixed to one database */
542 ){
543   int i;
544   struct ExprList_item *pItem;
545   if( pList==0 ) return 0;
546   for(i=0, pItem=pList->a; i<pList->nExpr; i++, pItem++){
547     if( sqlite3FixExpr(pFix, pItem->pExpr) ){
548       return 1;
549     }
550   }
551   return 0;
552 }
553 #endif
554 
555 #ifndef SQLITE_OMIT_TRIGGER
556 int sqlite3FixTriggerStep(
557   DbFixer *pFix,     /* Context of the fixation */
558   TriggerStep *pStep /* The trigger step be fixed to one database */
559 ){
560   while( pStep ){
561     if( sqlite3FixSelect(pFix, pStep->pSelect) ){
562       return 1;
563     }
564     if( sqlite3FixExpr(pFix, pStep->pWhere) ){
565       return 1;
566     }
567     if( sqlite3FixExprList(pFix, pStep->pExprList) ){
568       return 1;
569     }
570     pStep = pStep->pNext;
571   }
572   return 0;
573 }
574 #endif
575