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
|
<?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
-
-
-->
<refentry id="fn_vd_remote_table">
<refmeta>
<refentrytitle>vd_remote_table</refentrytitle>
<refmiscinfo>rmt</refmiscinfo>
</refmeta>
<refnamediv>
<refname>vd_remote_table</refname>
<refpurpose>declares an existing table as resident on a DSN previously declared with vd_remote_data_source</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_vd_remote_table">
<funcprototype id="fproto_vd_remote_table">
<funcdef><function>vd_remote_table</function></funcdef>
<paramdef>in <parameter>dsn</parameter> varchar</paramdef>
<paramdef>in <parameter>local_name</parameter> varchar</paramdef>
<paramdef>in <parameter>remote_name</parameter> varchar</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_vd_remote_table">
<title>Description</title>
<para>
Declares an existing table as resident on a data source previously
declared with vd_remote_data_source().
</para>
<para>
This function declares the table local_name as table remote_name on
the dsn. The tables names should be full, names with qualifier and
owner. The names are case sensitive and must be in the exact case where
they appear in the local and remote schemas.
</para>
<para>
If remote_name is NULL, the effect of a possible previous vd_remote_table
is reversed. The table is thereafter treated as a local table, except
in procedures and statements compiled when the remote declaration was
in effect.
</para>
</refsect1>
<refsect1 id="params_vd_remote_table"><title>Parameters</title>
<refsect2><title>dsn</title>
<para>The name of the remote datasource previously connected using vd_remote_data_source()</para></refsect2>
<refsect2><title>local_name</title>
<para>Fully qualified name of a local table.</para></refsect2>
<refsect2><title>remote_name</title>
<para>Fully qualified name of the remote table.</para></refsect2>
</refsect1>
<refsect1 id="seealso_vd_remote_table"><title>See Also</title>
<para><link linkend="fn_vd_remote_data_source">vd_remote_data_source()</link></para>
<para><link linkend="MANSETRDS">Manually Setting Up A Remote Data Source</link></para>
</refsect1>
</refentry>
|
