2 * Bacula Catalog Database Find record interface routines
4 * Note, generally, these routines are more complicated
5 * that a simple search by name or id. Such simple
8 * Kern Sibbald, December 2000
14 Copyright (C) 2000-2004 Kern Sibbald and John Walker
16 This program is free software; you can redistribute it and/or
17 modify it under the terms of the GNU General Public License as
18 published by the Free Software Foundation; either version 2 of
19 the License, or (at your option) any later version.
21 This program is distributed in the hope that it will be useful,
22 but WITHOUT ANY WARRANTY; without even the implied warranty of
23 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
24 General Public License for more details.
26 You should have received a copy of the GNU General Public
27 License along with this program; if not, write to the Free
28 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
34 /* The following is necessary so that we do not include
35 * the dummy external definition of DB.
37 #define __SQL_C /* indicate that this is sql.c */
42 #if HAVE_MYSQL || HAVE_SQLITE || HAVE_POSTGRESQL
44 /* -----------------------------------------------------------------------
46 * Generic Routines (or almost generic)
48 * -----------------------------------------------------------------------
51 /* Imported subroutines */
52 extern void print_result(B_DB *mdb);
53 extern int QueryDB(const char *file, int line, JCR *jcr, B_DB *db, char *select_cmd);
56 * Find job start time if JobId specified, otherwise
57 * find last full save for Incremental and Differential saves.
59 * StartTime is returned in stime
61 * Returns: 0 on failure
62 * 1 on success, jr is unchanged, but stime is set
65 db_find_job_start_time(JCR *jcr, B_DB *mdb, JOB_DBR *jr, POOLMEM **stime)
71 pm_strcpy(stime, "0000-00-00 00:00:00"); /* default */
72 /* If no Id given, we must find corresponding job */
74 /* Differential is since last Full backup */
76 "SELECT StartTime FROM Job WHERE JobStatus='T' AND Type='%c' AND "
77 "Level='%c' AND Name='%s' AND ClientId=%u AND FileSetId=%u "
78 "ORDER BY StartTime DESC LIMIT 1",
79 jr->JobType, L_FULL, jr->Name, jr->ClientId, jr->FileSetId);
81 if (jr->JobLevel == L_DIFFERENTIAL) {
82 /* SQL cmd for Differential backup already edited above */
84 /* Incremental is since last Full, Incremental, or Differential */
85 } else if (jr->JobLevel == L_INCREMENTAL) {
87 * For an Incremental job, we must first ensure
88 * that a Full backup was done (cmd edited above)
89 * then we do a second look to find the most recent
92 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
93 Mmsg2(&mdb->errmsg, _("Query error for start time request: ERR=%s\nCMD=%s\n"),
94 sql_strerror(mdb), mdb->cmd);
98 if ((row = sql_fetch_row(mdb)) == NULL) {
100 Mmsg(mdb->errmsg, _("No prior Full backup Job record found.\n"));
104 sql_free_result(mdb);
105 /* Now edit SQL command for Incremental Job */
107 "SELECT StartTime FROM Job WHERE JobStatus='T' AND Type='%c' AND "
108 "Level IN ('%c','%c','%c') AND Name='%s' AND ClientId=%u "
109 "AND FileSetId=%u ORDER BY StartTime DESC LIMIT 1",
110 jr->JobType, L_INCREMENTAL, L_DIFFERENTIAL, L_FULL, jr->Name,
111 jr->ClientId, jr->FileSetId);
113 Mmsg1(&mdb->errmsg, _("Unknown level=%d\n"), jr->JobLevel);
118 Dmsg1(100, "Submitting: %s\n", mdb->cmd);
119 Mmsg(mdb->cmd, "SELECT StartTime FROM Job WHERE Job.JobId=%u", jr->JobId);
122 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
123 pm_strcpy(stime, ""); /* set EOS */
124 Mmsg2(&mdb->errmsg, _("Query error for start time request: ERR=%s\nCMD=%s\n"),
125 sql_strerror(mdb), mdb->cmd);
130 if ((row = sql_fetch_row(mdb)) == NULL) {
131 Mmsg2(&mdb->errmsg, _("No Job record found: ERR=%s\nCMD=%s\n"),
132 sql_strerror(mdb), mdb->cmd);
133 sql_free_result(mdb);
137 Dmsg1(100, "Got start time: %s\n", row[0]);
138 pm_strcpy(stime, row[0]);
140 sql_free_result(mdb);
147 * Find last failed job since given start-time
148 * it must be either Full or Diff.
150 * Returns: false on failure
151 * true on success, jr is unchanged and stime unchanged
152 * level returned in JobLevel
155 db_find_failed_job_since(JCR *jcr, B_DB *mdb, JOB_DBR *jr, POOLMEM *stime, int &JobLevel)
160 /* Differential is since last Full backup */
162 "SELECT Level FROM Job WHERE JobStatus!='T' AND Type='%c' AND "
163 "Level IN ('%c','%c') AND Name='%s' AND ClientId=%u "
164 "AND FileSetId=%u AND StartTime>'%s' "
165 "ORDER BY StartTime DESC LIMIT 1",
166 jr->JobType, L_FULL, L_DIFFERENTIAL, jr->Name,
167 jr->ClientId, jr->FileSetId, stime);
169 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
174 if ((row = sql_fetch_row(mdb)) == NULL) {
175 sql_free_result(mdb);
179 JobLevel = (int)*row[0];
180 sql_free_result(mdb);
188 * Find JobId of last job that ran. E.g. for
189 * VERIFY_CATALOG we want the JobId of the last INIT.
190 * For VERIFY_VOLUME_TO_CATALOG, we want the JobId of the last Job.
192 * Returns: 1 on success
196 db_find_last_jobid(JCR *jcr, B_DB *mdb, const char *Name, JOB_DBR *jr)
202 if (jr->JobLevel == L_VERIFY_CATALOG) {
204 "SELECT JobId FROM Job WHERE Type='V' AND Level='%c' AND "
205 " JobStatus='T' AND Name='%s' AND "
206 "ClientId=%u ORDER BY StartTime DESC LIMIT 1",
207 L_VERIFY_INIT, jr->Name, jr->ClientId);
208 } else if (jr->JobLevel == L_VERIFY_VOLUME_TO_CATALOG ||
209 jr->JobLevel == L_VERIFY_DISK_TO_CATALOG) {
212 "SELECT JobId FROM Job WHERE Type='B' AND JobStatus='T' AND "
213 "Name='%s' ORDER BY StartTime DESC LIMIT 1", Name);
216 "SELECT JobId FROM Job WHERE Type='B' AND JobStatus='T' AND "
217 "ClientId=%u ORDER BY StartTime DESC LIMIT 1", jr->ClientId);
220 Mmsg1(&mdb->errmsg, _("Unknown Job level=%c\n"), jr->JobLevel);
224 Dmsg1(100, "Query: %s\n", mdb->cmd);
225 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
229 if ((row = sql_fetch_row(mdb)) == NULL) {
230 Mmsg1(&mdb->errmsg, _("No Job found for: %s.\n"), mdb->cmd);
231 sql_free_result(mdb);
236 jr->JobId = atoi(row[0]);
237 sql_free_result(mdb);
239 Dmsg1(100, "db_get_last_jobid: got JobId=%d\n", jr->JobId);
240 if (jr->JobId <= 0) {
241 Mmsg1(&mdb->errmsg, _("No Job found for: %s\n"), mdb->cmd);
251 * Find Available Media (Volume) for Pool
253 * Find a Volume for a given PoolId, MediaType, and Status.
255 * Returns: 0 on failure
259 db_find_next_volume(JCR *jcr, B_DB *mdb, int item, bool InChanger, MEDIA_DBR *mr)
263 const char *changer, *order;
266 if (item == -1) { /* find oldest volume */
267 /* Find oldest volume */
268 Mmsg(mdb->cmd, "SELECT MediaId,VolumeName,VolJobs,VolFiles,VolBlocks,"
269 "VolBytes,VolMounts,VolErrors,VolWrites,MaxVolBytes,VolCapacityBytes,"
270 "VolRetention,VolUseDuration,MaxVolJobs,MaxVolFiles,Recycle,Slot,"
271 "FirstWritten,LastWritten,VolStatus,InChanger,VolParts "
272 "FROM Media WHERE PoolId=%u AND MediaType='%s' AND VolStatus IN ('Full',"
273 "'Recycle','Purged','Used','Append') "
274 "ORDER BY LastWritten LIMIT 1", mr->PoolId, mr->MediaType);
277 /* Find next available volume */
279 changer = "AND InChanger=1";
283 if (strcmp(mr->VolStatus, "Recycled") == 0 ||
284 strcmp(mr->VolStatus, "Purged") == 0) {
285 order = "ORDER BY LastWritten ASC,MediaId"; /* take oldest */
287 order = "ORDER BY LastWritten IS NULL,LastWritten DESC,MediaId"; /* take most recently written */
289 Mmsg(mdb->cmd, "SELECT MediaId,VolumeName,VolJobs,VolFiles,VolBlocks,"
290 "VolBytes,VolMounts,VolErrors,VolWrites,MaxVolBytes,VolCapacityBytes,"
291 "VolRetention,VolUseDuration,MaxVolJobs,MaxVolFiles,Recycle,Slot,"
292 "FirstWritten,LastWritten,VolStatus,InChanger,VolParts "
293 "FROM Media WHERE PoolId=%u AND MediaType='%s' AND VolStatus='%s' "
296 mr->PoolId, mr->MediaType, mr->VolStatus, changer, order, item);
298 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
303 numrows = sql_num_rows(mdb);
304 if (item > numrows) {
305 Mmsg2(&mdb->errmsg, _("Request for Volume item %d greater than max %d\n"),
311 /* Seek to desired item
312 * Note, we use base 1; SQL uses base 0
314 sql_data_seek(mdb, item-1);
316 if ((row = sql_fetch_row(mdb)) == NULL) {
317 Mmsg1(&mdb->errmsg, _("No Volume record found for item %d.\n"), item);
318 sql_free_result(mdb);
323 /* Return fields in Media Record */
324 mr->MediaId = str_to_int64(row[0]);
325 bstrncpy(mr->VolumeName, row[1], sizeof(mr->VolumeName));
326 mr->VolJobs = str_to_int64(row[2]);
327 mr->VolFiles = str_to_int64(row[3]);
328 mr->VolBlocks = str_to_int64(row[4]);
329 mr->VolBytes = str_to_uint64(row[5]);
330 mr->VolMounts = str_to_int64(row[6]);
331 mr->VolErrors = str_to_int64(row[7]);
332 mr->VolWrites = str_to_int64(row[8]);
333 mr->MaxVolBytes = str_to_uint64(row[9]);
334 mr->VolCapacityBytes = str_to_uint64(row[10]);
335 mr->VolRetention = str_to_uint64(row[11]);
336 mr->VolUseDuration = str_to_uint64(row[12]);
337 mr->MaxVolJobs = str_to_int64(row[13]);
338 mr->MaxVolFiles = str_to_int64(row[14]);
339 mr->Recycle = str_to_int64(row[15]);
340 mr->Slot = str_to_int64(row[16]);
341 bstrncpy(mr->cFirstWritten, row[17]!=NULL?row[17]:"", sizeof(mr->cFirstWritten));
342 mr->FirstWritten = (time_t)str_to_utime(mr->cFirstWritten);
343 bstrncpy(mr->cLastWritten, row[18]!=NULL?row[18]:"", sizeof(mr->cLastWritten));
344 mr->LastWritten = (time_t)str_to_utime(mr->cLastWritten);
345 bstrncpy(mr->VolStatus, row[19], sizeof(mr->VolStatus));
346 mr->InChanger = str_to_int64(row[20]);
347 mr->VolParts = str_to_int64(row[21]);
348 sql_free_result(mdb);
355 #endif /* HAVE_MYSQL || HAVE_SQLITE || HAVE_POSTGRESQL */