1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
project.
Copyright (C) 1998-2018 OpenLink Software
This project is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; only version 2 of the License, dated June 1991.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
: template.sh,v 1.5 2006/04/18 21:59:13 ivan Exp $
-->
<refentry id="fn_rdf_restore_metadata">
<refmeta>
<refentrytitle>DB.DBA.RDF_RESTORE_METADATA</refentrytitle>
<refmiscinfo>rdf</refmiscinfo>
</refmeta>
<refnamediv>
<refname>DB.DBA.RDF_RESTORE_METADATA</refname>
<refpurpose>Restores RDF metadata (descriptions of Linked Data Views and the like) from previously saved backup.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_rdf_restore_metadata">
<funcprototype id="fproto_rdf_restore_metadata">
<funcdef><function>DB.DBA.RDF_RESTORE_METADATA</function></funcdef>
<paramdef>in <parameter>read_from_file</parameter> integer</paramdef>
<paramdef>in <parameter>backup_name</parameter> varchar</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_rdf_restore_metadata">
<title>Description</title>
<para>This restores RDF metadata from specified file or graph in RDF storage.
The file or graph should be previously created by
<link linkend="fn_rdf_backup_metadata"><function>DB.DBA.RDF_BACKUP_METADATA</function>()</link>.
It is usually safe to restore metadata from backup made by some previous version of Virtuoso server but
it is good idea to call <link linkend="fn_rdf_audit_metadata"><function>DB.DBA.RDF_AUDIT_METADATA</function>()</link> after such restore.
</para>
<para>When the procedure is executed on the server that continues to serve user requests during the maintenance then SPARQL query compiler may interrupt query compilations or create queries that will return incomplete result sets.
These queries may be cached till the end of metadata update procedure but the cache is flushed when the update is complete, so possible errors will be transient.
If even transient errors are not appropriate then do RDF metadata update with all precautions usual for changing database schema of an application.
</para>
</refsect1>
<refsect1 id="params_rdf_restore_metadata">
<title>Parameters</title>
<refsect2><title>read_from_file</title>
<para>This flag specifies the type of the origin: it should be nonzero for file, zero for graph.</para>
</refsect2>
<refsect2><title>backup_name</title>
<para>Name of backup file or graph as it is returned by the call of
<link linkend="fn_rdf_backup_metadata"><function>DB.DBA.RDF_BACKUP_METADATA</function>()</link> that created the backup.</para>
</refsect2>
</refsect1>
<refsect1 id="ret_rdf_restore_metadata"><title>Return Types</title>
<para>The return value is not specified and may be changed in future versions.</para>
</refsect1>
<!-- <refsect1 id="errors_rdf_restore_metadata">
<title>Errors</title>
<para>This function can generate the following errors:</para>
<errorcode></errorcode>
</refsect1>
<refsect1 id="examples_rdf_restore_metadata">
<title>Examples</title>
<example id="ex_rdf_restore_metadata"><title></title>
<para></para>
<screen><![CDATA[
]]>
</screen>
</example>
</refsect1>-->
<refsect1 id="seealso_rdf_restore_metadata">
<title>See Also</title>
<para><link linkend="fn_rdf_audit_metadata"><function>DB.DBA.RDF_AUDIT_METADATA()</function></link></para>
<para><link linkend="fn_rdf_backup_metadata"><function>DB.DBA.RDF_BACKUP_METADATA()</function></link></para>
</refsect1>
</refentry>
|
