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 JobId of last job that ran. E.g. for
148 * VERIFY_CATALOG we want the JobId of the last INIT.
149 * For VERIFY_VOLUME_TO_CATALOG, we want the JobId of the last Job.
151 * Returns: 1 on success
155 db_find_last_jobid(JCR *jcr, B_DB *mdb, const char *Name, JOB_DBR *jr)
161 if (jr->JobLevel == L_VERIFY_CATALOG) {
163 "SELECT JobId FROM Job WHERE Type='V' AND Level='%c' AND "
164 " JobStatus='T' AND Name='%s' AND "
165 "ClientId=%u ORDER BY StartTime DESC LIMIT 1",
166 L_VERIFY_INIT, jr->Name, jr->ClientId);
167 } else if (jr->JobLevel == L_VERIFY_VOLUME_TO_CATALOG ||
168 jr->JobLevel == L_VERIFY_DISK_TO_CATALOG) {
171 "SELECT JobId FROM Job WHERE Type='B' AND JobStatus='T' AND "
172 "Name='%s' ORDER BY StartTime DESC LIMIT 1", Name);
175 "SELECT JobId FROM Job WHERE Type='B' AND JobStatus='T' AND "
176 "ClientId=%u ORDER BY StartTime DESC LIMIT 1", jr->ClientId);
179 Mmsg1(&mdb->errmsg, _("Unknown Job level=%c\n"), jr->JobLevel);
183 Dmsg1(100, "Query: %s\n", mdb->cmd);
184 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
188 if ((row = sql_fetch_row(mdb)) == NULL) {
189 Mmsg1(&mdb->errmsg, _("No Job found for: %s.\n"), mdb->cmd);
190 sql_free_result(mdb);
195 jr->JobId = atoi(row[0]);
196 sql_free_result(mdb);
198 Dmsg1(100, "db_get_last_jobid: got JobId=%d\n", jr->JobId);
199 if (jr->JobId <= 0) {
200 Mmsg1(&mdb->errmsg, _("No Job found for: %s\n"), mdb->cmd);
210 * Find Available Media (Volume) for Pool
212 * Find a Volume for a given PoolId, MediaType, and Status.
214 * Returns: 0 on failure
218 db_find_next_volume(JCR *jcr, B_DB *mdb, int item, bool InChanger, MEDIA_DBR *mr)
222 const char *changer, *order;
225 if (item == -1) { /* find oldest volume */
226 /* Find oldest volume */
227 Mmsg(mdb->cmd, "SELECT MediaId,VolumeName,VolJobs,VolFiles,VolBlocks,"
228 "VolBytes,VolMounts,VolErrors,VolWrites,MaxVolBytes,VolCapacityBytes,"
229 "VolRetention,VolUseDuration,MaxVolJobs,MaxVolFiles,Recycle,Slot,"
230 "FirstWritten,LastWritten,VolStatus,InChanger "
231 "FROM Media WHERE PoolId=%u AND MediaType='%s' AND VolStatus IN ('Full',"
232 "'Recycle','Purged','Used','Append') "
233 "ORDER BY LastWritten LIMIT 1", mr->PoolId, mr->MediaType);
236 /* Find next available volume */
238 changer = "AND InChanger=1";
242 if (strcmp(mr->VolStatus, "Recycled") == 0 ||
243 strcmp(mr->VolStatus, "Purged") == 0) {
244 order = "ORDER BY LastWritten ASC,MediaId"; /* take oldest */
246 order = "ORDER BY LastWritten IS NULL,LastWritten DESC,MediaId"; /* take most recently written */
248 Mmsg(mdb->cmd, "SELECT MediaId,VolumeName,VolJobs,VolFiles,VolBlocks,"
249 "VolBytes,VolMounts,VolErrors,VolWrites,MaxVolBytes,VolCapacityBytes,"
250 "VolRetention,VolUseDuration,MaxVolJobs,MaxVolFiles,Recycle,Slot,"
251 "FirstWritten,LastWritten,VolStatus,InChanger "
252 "FROM Media WHERE PoolId=%u AND MediaType='%s' AND VolStatus='%s' "
255 mr->PoolId, mr->MediaType, mr->VolStatus, changer, order, item);
257 if (!QUERY_DB(jcr, mdb, mdb->cmd)) {
262 numrows = sql_num_rows(mdb);
263 if (item > numrows) {
264 Mmsg2(&mdb->errmsg, _("Request for Volume item %d greater than max %d\n"),
270 /* Seek to desired item
271 * Note, we use base 1; SQL uses base 0
273 sql_data_seek(mdb, item-1);
275 if ((row = sql_fetch_row(mdb)) == NULL) {
276 Mmsg1(&mdb->errmsg, _("No Volume record found for item %d.\n"), item);
277 sql_free_result(mdb);
282 /* Return fields in Media Record */
283 mr->MediaId = str_to_int64(row[0]);
284 bstrncpy(mr->VolumeName, row[1], sizeof(mr->VolumeName));
285 mr->VolJobs = str_to_int64(row[2]);
286 mr->VolFiles = str_to_int64(row[3]);
287 mr->VolBlocks = str_to_int64(row[4]);
288 mr->VolBytes = str_to_uint64(row[5]);
289 mr->VolMounts = str_to_int64(row[6]);
290 mr->VolErrors = str_to_int64(row[7]);
291 mr->VolWrites = str_to_int64(row[8]);
292 mr->MaxVolBytes = str_to_uint64(row[9]);
293 mr->VolCapacityBytes = str_to_uint64(row[10]);
294 mr->VolRetention = str_to_uint64(row[11]);
295 mr->VolUseDuration = str_to_uint64(row[12]);
296 mr->MaxVolJobs = str_to_int64(row[13]);
297 mr->MaxVolFiles = str_to_int64(row[14]);
298 mr->Recycle = str_to_int64(row[15]);
299 mr->Slot = str_to_int64(row[16]);
300 bstrncpy(mr->cFirstWritten, row[17]!=NULL?row[17]:"", sizeof(mr->cFirstWritten));
301 mr->FirstWritten = (time_t)str_to_utime(mr->cFirstWritten);
302 bstrncpy(mr->cLastWritten, row[18]!=NULL?row[18]:"", sizeof(mr->cLastWritten));
303 mr->LastWritten = (time_t)str_to_utime(mr->cLastWritten);
304 bstrncpy(mr->VolStatus, row[19], sizeof(mr->VolStatus));
305 mr->InChanger = str_to_int64(row[20]);
306 sql_free_result(mdb);
313 #endif /* HAVE_MYSQL || HAVE_SQLITE || HAVE_POSTGRESQL */