4 ** The author disclaims copyright to this source code. In place of
5 ** a legal notice, here is a blessing:
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.
11 *************************************************************************
12 ** This file contains code used to implement the ATTACH and DETACH commands.
14 #include "sqliteInt.h"
16 #ifndef SQLITE_OMIT_ATTACH
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.
22 ** i.e. if the parser sees:
24 ** ATTACH DATABASE abc AS def
26 ** it treats the two expressions as literal strings 'abc' and 'def' instead of
27 ** looking for columns of the same name.
29 ** This only applies to the root node of pExpr, so the statement:
31 ** ATTACH DATABASE abc||def AS 'db2'
33 ** will fail because neither abc or def can be resolved.
35 static int resolveAttachExpr(NameContext
*pName
, Expr
*pExpr
)
39 if( pExpr
->op
!=TK_ID
){
40 rc
= sqlite3ResolveExprNames(pName
, pExpr
);
42 pExpr
->op
= TK_STRING
;
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:
52 ** ATTACH DATABASE x AS y KEY z
54 ** SELECT sqlite_attach(x, y, z)
56 ** If the optional "KEY z" syntax is omitted, an SQL NULL is passed as the
59 static void attachFunc(
60 sqlite3_context
*context
,
66 sqlite3
*db
= sqlite3_context_db_handle(context
);
76 UNUSED_PARAMETER(NotUsed
);
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
= "";
83 /* Check for the following errors:
85 ** * Too many attached databases,
86 ** * Transaction currently open
87 ** * Specified database name already being used.
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
]
95 if( !db
->autoCommit
){
96 zErrDyn
= sqlite3MPrintf(db
, "cannot ATTACH database within transaction");
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
);
108 /* Allocate the new entry in the db->aDb[] array and initialize the schema
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);
116 aNew
= sqlite3DbRealloc(db
, db
->aDb
, sizeof(db
->aDb
[0])*(db
->nDb
+1) );
117 if( aNew
==0 ) return;
120 aNew
= &db
->aDb
[db
->nDb
];
121 memset(aNew
, 0, sizeof(*aNew
));
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.
127 flags
= db
->openFlags
;
128 rc
= sqlite3ParseUri(db
->pVfs
->zName
, zFile
, &flags
, &pVfs
, &zPath
, &zErr
);
130 if( rc
==SQLITE_NOMEM
) db
->mallocFailed
= 1;
131 sqlite3_result_error(context
, zErr
, -1);
136 flags
|= SQLITE_OPEN_MAIN_DB
;
137 rc
= sqlite3BtreeOpen(pVfs
, zPath
, db
, &aNew
->pBt
, 0, flags
);
138 sqlite3_free( zPath
);
140 if( rc
==SQLITE_CONSTRAINT
){
142 zErrDyn
= sqlite3MPrintf(db
, "database is already attached");
143 }else if( rc
==SQLITE_OK
){
145 aNew
->pSchema
= sqlite3SchemaGet(db
, aNew
->pBt
);
146 if( !aNew
->pSchema
){
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");
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
));
161 aNew
->safety_level
= 3;
162 aNew
->zName
= sqlite3DbStrDup(db
, zName
);
163 if( rc
==SQLITE_OK
&& aNew
->zName
==0 ){
168 #ifdef SQLITE_HAS_CODEC
170 extern int sqlite3CodecAttach(sqlite3
*, int, const void*, int);
171 extern void sqlite3CodecGetKey(sqlite3
*, int, void**, int*);
174 int t
= sqlite3_value_type(argv
[2]);
178 zErrDyn
= sqlite3DbStrDup(db
, "Invalid key value");
184 nKey
= sqlite3_value_bytes(argv
[2]);
185 zKey
= (char *)sqlite3_value_blob(argv
[2]);
186 rc
= sqlite3CodecAttach(db
, db
->nDb
-1, zKey
, nKey
);
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
);
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
206 sqlite3BtreeEnterAll(db
);
207 rc
= sqlite3Init(db
, &zErrDyn
);
208 sqlite3BtreeLeaveAll(db
);
210 #ifdef SQLITE_USER_AUTHENTICATION
213 rc
= sqlite3UserAuthCheckLogin(db
, zName
, &newAuth
);
214 if( newAuth
<db
->auth
.authLevel
){
215 rc
= SQLITE_AUTH_USER
;
220 int iDb
= db
->nDb
- 1;
222 if( db
->aDb
[iDb
].pBt
){
223 sqlite3BtreeClose(db
->aDb
[iDb
].pBt
);
224 db
->aDb
[iDb
].pBt
= 0;
225 db
->aDb
[iDb
].pSchema
= 0;
227 sqlite3ResetAllSchemasOfConnection(db
);
229 if( rc
==SQLITE_NOMEM
|| rc
==SQLITE_IOERR_NOMEM
){
230 db
->mallocFailed
= 1;
231 sqlite3DbFree(db
, zErrDyn
);
232 zErrDyn
= sqlite3MPrintf(db
, "out of memory");
233 }else if( zErrDyn
==0 ){
234 zErrDyn
= sqlite3MPrintf(db
, "unable to open database: %s", zFile
);
242 /* Return an error if we get here */
244 sqlite3_result_error(context
, zErrDyn
, -1);
245 sqlite3DbFree(db
, zErrDyn
);
247 if( rc
) sqlite3_result_error_code(context
, rc
);
251 ** An SQL user-function registered to do the work of an DETACH statement. The
252 ** three arguments to the function come directly from a detach statement:
256 ** SELECT sqlite_detach(x)
258 static void detachFunc(
259 sqlite3_context
*context
,
263 const char *zName
= (const char *)sqlite3_value_text(argv
[0]);
264 sqlite3
*db
= sqlite3_context_db_handle(context
);
269 UNUSED_PARAMETER(NotUsed
);
271 if( zName
==0 ) zName
= "";
272 for(i
=0; i
<db
->nDb
; i
++){
274 if( pDb
->pBt
==0 ) continue;
275 if( sqlite3StrICmp(pDb
->zName
, zName
)==0 ) break;
279 sqlite3_snprintf(sizeof(zErr
),zErr
, "no such database: %s", zName
);
283 sqlite3_snprintf(sizeof(zErr
),zErr
, "cannot detach database %s", zName
);
286 if( !db
->autoCommit
){
287 sqlite3_snprintf(sizeof(zErr
), zErr
,
288 "cannot DETACH database within transaction");
291 if( sqlite3BtreeIsInReadTrans(pDb
->pBt
) || sqlite3BtreeIsInBackup(pDb
->pBt
) ){
292 sqlite3_snprintf(sizeof(zErr
),zErr
, "database %s is locked", zName
);
296 sqlite3BtreeClose(pDb
->pBt
);
299 sqlite3ResetAllSchemasOfConnection(db
);
303 sqlite3_result_error(context
, zErr
, -1);
307 ** This procedure generates VDBE code for a single invocation of either the
308 ** sqlite_detach() or sqlite_attach() SQL user functions.
310 static void codeAttach(
311 Parse
*pParse
, /* The parser context */
312 int type
, /* Either SQLITE_ATTACH or SQLITE_DETACH */
313 FuncDef
const *pFunc
,/* FuncDef wrapper for detachFunc() or attachFunc() */
314 Expr
*pAuthArg
, /* Expression to pass to authorization callback */
315 Expr
*pFilename
, /* Name of database file */
316 Expr
*pDbname
, /* Name of the database to use internally */
317 Expr
*pKey
/* Database key for encryption extension */
322 sqlite3
* db
= pParse
->db
;
325 memset(&sName
, 0, sizeof(NameContext
));
326 sName
.pParse
= pParse
;
329 SQLITE_OK
!=(rc
= resolveAttachExpr(&sName
, pFilename
)) ||
330 SQLITE_OK
!=(rc
= resolveAttachExpr(&sName
, pDbname
)) ||
331 SQLITE_OK
!=(rc
= resolveAttachExpr(&sName
, pKey
))
337 #ifndef SQLITE_OMIT_AUTHORIZATION
340 if( pAuthArg
->op
==TK_STRING
){
341 zAuthArg
= pAuthArg
->u
.zToken
;
345 rc
= sqlite3AuthCheck(pParse
, type
, zAuthArg
, 0, 0);
350 #endif /* SQLITE_OMIT_AUTHORIZATION */
353 v
= sqlite3GetVdbe(pParse
);
354 regArgs
= sqlite3GetTempRange(pParse
, 4);
355 sqlite3ExprCode(pParse
, pFilename
, regArgs
);
356 sqlite3ExprCode(pParse
, pDbname
, regArgs
+1);
357 sqlite3ExprCode(pParse
, pKey
, regArgs
+2);
359 assert( v
|| db
->mallocFailed
);
361 sqlite3VdbeAddOp3(v
, OP_Function
, 0, regArgs
+3-pFunc
->nArg
, regArgs
+3);
362 assert( pFunc
->nArg
==-1 || (pFunc
->nArg
&0xff)==pFunc
->nArg
);
363 sqlite3VdbeChangeP5(v
, (u8
)(pFunc
->nArg
));
364 sqlite3VdbeChangeP4(v
, -1, (char *)pFunc
, P4_FUNCDEF
);
366 /* Code an OP_Expire. For an ATTACH statement, set P1 to true (expire this
367 ** statement only). For DETACH, set it to false (expire all existing
370 sqlite3VdbeAddOp1(v
, OP_Expire
, (type
==SQLITE_ATTACH
));
374 sqlite3ExprDelete(db
, pFilename
);
375 sqlite3ExprDelete(db
, pDbname
);
376 sqlite3ExprDelete(db
, pKey
);
380 ** Called by the parser to compile a DETACH statement.
384 void sqlite3Detach(Parse
*pParse
, Expr
*pDbname
){
385 static const FuncDef detach_func
= {
387 SQLITE_UTF8
, /* funcFlags */
390 detachFunc
, /* xFunc */
393 "sqlite_detach", /* zName */
397 codeAttach(pParse
, SQLITE_DETACH
, &detach_func
, pDbname
, 0, 0, pDbname
);
401 ** Called by the parser to compile an ATTACH statement.
403 ** ATTACH p AS pDbname KEY pKey
405 void sqlite3Attach(Parse
*pParse
, Expr
*p
, Expr
*pDbname
, Expr
*pKey
){
406 static const FuncDef attach_func
= {
408 SQLITE_UTF8
, /* funcFlags */
411 attachFunc
, /* xFunc */
414 "sqlite_attach", /* zName */
418 codeAttach(pParse
, SQLITE_ATTACH
, &attach_func
, p
, p
, pDbname
, pKey
);
420 #endif /* SQLITE_OMIT_ATTACH */
423 ** Initialize a DbFixer structure. This routine must be called prior
424 ** to passing the structure to one of the sqliteFixAAAA() routines below.
427 DbFixer
*pFix
, /* The fixer to be initialized */
428 Parse
*pParse
, /* Error messages will be written here */
429 int iDb
, /* This is the database that must be used */
430 const char *zType
, /* "view", "trigger", or "index" */
431 const Token
*pName
/* Name of the view, trigger, or index */
436 assert( db
->nDb
>iDb
);
437 pFix
->pParse
= pParse
;
438 pFix
->zDb
= db
->aDb
[iDb
].zName
;
439 pFix
->pSchema
= db
->aDb
[iDb
].pSchema
;
442 pFix
->bVarOnly
= (iDb
==1);
446 ** The following set of routines walk through the parse tree and assign
447 ** a specific database to all table references where the database name
448 ** was left unspecified in the original SQL statement. The pFix structure
449 ** must have been initialized by a prior call to sqlite3FixInit().
451 ** These routines are used to make sure that an index, trigger, or
452 ** view in one database does not refer to objects in a different database.
453 ** (Exception: indices, triggers, and views in the TEMP database are
454 ** allowed to refer to anything.) If a reference is explicitly made
455 ** to an object in a different database, an error message is added to
456 ** pParse->zErrMsg and these routines return non-zero. If everything
457 ** checks out, these routines return 0.
459 int sqlite3FixSrcList(
460 DbFixer
*pFix
, /* Context of the fixation */
461 SrcList
*pList
/* The Source list to check and modify */
465 struct SrcList_item
*pItem
;
467 if( NEVER(pList
==0) ) return 0;
469 for(i
=0, pItem
=pList
->a
; i
<pList
->nSrc
; i
++, pItem
++){
470 if( pFix
->bVarOnly
==0 ){
471 if( pItem
->zDatabase
&& sqlite3StrICmp(pItem
->zDatabase
, zDb
) ){
472 sqlite3ErrorMsg(pFix
->pParse
,
473 "%s %T cannot reference objects in database %s",
474 pFix
->zType
, pFix
->pName
, pItem
->zDatabase
);
477 sqlite3DbFree(pFix
->pParse
->db
, pItem
->zDatabase
);
478 pItem
->zDatabase
= 0;
479 pItem
->pSchema
= pFix
->pSchema
;
481 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER)
482 if( sqlite3FixSelect(pFix
, pItem
->pSelect
) ) return 1;
483 if( sqlite3FixExpr(pFix
, pItem
->pOn
) ) return 1;
488 #if !defined(SQLITE_OMIT_VIEW) || !defined(SQLITE_OMIT_TRIGGER)
489 int sqlite3FixSelect(
490 DbFixer
*pFix
, /* Context of the fixation */
491 Select
*pSelect
/* The SELECT statement to be fixed to one database */
494 if( sqlite3FixExprList(pFix
, pSelect
->pEList
) ){
497 if( sqlite3FixSrcList(pFix
, pSelect
->pSrc
) ){
500 if( sqlite3FixExpr(pFix
, pSelect
->pWhere
) ){
503 if( sqlite3FixExprList(pFix
, pSelect
->pGroupBy
) ){
506 if( sqlite3FixExpr(pFix
, pSelect
->pHaving
) ){
509 if( sqlite3FixExprList(pFix
, pSelect
->pOrderBy
) ){
512 if( sqlite3FixExpr(pFix
, pSelect
->pLimit
) ){
515 if( sqlite3FixExpr(pFix
, pSelect
->pOffset
) ){
518 pSelect
= pSelect
->pPrior
;
523 DbFixer
*pFix
, /* Context of the fixation */
524 Expr
*pExpr
/* The expression to be fixed to one database */
527 if( pExpr
->op
==TK_VARIABLE
){
528 if( pFix
->pParse
->db
->init
.busy
){
531 sqlite3ErrorMsg(pFix
->pParse
, "%s cannot use variables", pFix
->zType
);
535 if( ExprHasProperty(pExpr
, EP_TokenOnly
) ) break;
536 if( ExprHasProperty(pExpr
, EP_xIsSelect
) ){
537 if( sqlite3FixSelect(pFix
, pExpr
->x
.pSelect
) ) return 1;
539 if( sqlite3FixExprList(pFix
, pExpr
->x
.pList
) ) return 1;
541 if( sqlite3FixExpr(pFix
, pExpr
->pRight
) ){
544 pExpr
= pExpr
->pLeft
;
548 int sqlite3FixExprList(
549 DbFixer
*pFix
, /* Context of the fixation */
550 ExprList
*pList
/* The expression to be fixed to one database */
553 struct ExprList_item
*pItem
;
554 if( pList
==0 ) return 0;
555 for(i
=0, pItem
=pList
->a
; i
<pList
->nExpr
; i
++, pItem
++){
556 if( sqlite3FixExpr(pFix
, pItem
->pExpr
) ){
564 #ifndef SQLITE_OMIT_TRIGGER
565 int sqlite3FixTriggerStep(
566 DbFixer
*pFix
, /* Context of the fixation */
567 TriggerStep
*pStep
/* The trigger step be fixed to one database */
570 if( sqlite3FixSelect(pFix
, pStep
->pSelect
) ){
573 if( sqlite3FixExpr(pFix
, pStep
->pWhere
) ){
576 if( sqlite3FixExprList(pFix
, pStep
->pExprList
) ){
579 pStep
= pStep
->pNext
;