vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0161.html
Lu, Huayi e6fa411af0 DWS DEV 830.201 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-05-16 07:24:04 +00:00

1465 lines
192 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<a name="EN-US_TOPIC_0000001233628569"></a><a name="EN-US_TOPIC_0000001233628569"></a>
<h1 class="topictitle1">CREATE FOREIGN TABLE (SQL on OBS or Hadoop)</h1>
<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001233628569__s007f04685f3045e5b9f1d6663b833ba6"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001233628569__p14299142214114"><strong id="EN-US_TOPIC_0000001233628569__b83597195288">CREATE FOREIGN TABLE</strong> creates an HDFS or OBS foreign table in the current database to access structured data stored on HDFS or OBS. You can also export data in ORC format to HDFS or OBS.</p>
<p id="EN-US_TOPIC_0000001233628569__p2336175494115">Data stored in OBS: Data storage is decoupled from compute. The cluster storage cost is low, and storage capacity is not limited. Clusters can be deleted at any time. However, the computing performance depends on the OBS access performance and is lower than that of HDFS. OBS is recommended for applications that do not demand a lot of computation.</p>
<p id="EN-US_TOPIC_0000001233628569__a5539e69e61514424bc1b8b74769744e4">Data stored in HDFS: Data storage is not decoupled from compute. The cluster storage cost is high, and storage capacity is limited. The computing performance is high. You must export data before you delete clusters. HDFS is recommended for computing-intensive scenarios.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note122379223317"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p7237822631">The hybrid data warehouse (standalone) does not support OBS and HDFS foreign table import and export.</p>
</div></div>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__section147351773619"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001233628569__ul18903929389"><li id="EN-US_TOPIC_0000001233628569__li19031213384">HDFS foreign tables and OBS foreign tables are classified into read-only and write-only foreign tables. Read-only foreign tables are used for query, and write-only foreign tables can be used to export data from <span id="EN-US_TOPIC_0000001233628569__text212113994">GaussDB(DWS)</span> to a distributed file system.</li><li id="EN-US_TOPIC_0000001233628569__li1566112917455">In this mode, data can be imported and queried in ORC, TEXT, CSV, CARBONDATA, PARQUET, or JSON format, and can be exported in ORC, CSV, or TEXT format.</li><li id="EN-US_TOPIC_0000001233628569__li837214673817">In this mode, you need to manually create a foreign server. For details, see <a href="dws_06_0175.html">CREATE SERVER</a>.</li><li id="EN-US_TOPIC_0000001233628569__li1466517941315">If the foreign data wrapper is set to <strong id="EN-US_TOPIC_0000001233628569__b774612206452">HDFS_FDW</strong> or <strong id="EN-US_TOPIC_0000001233628569__b19753132020452">DFS_FDW</strong> when you manually create a server, you need to specify the distribution mode in the <strong id="EN-US_TOPIC_0000001233628569__b12753112074513">DISTRIBUTE BY</strong> clause when creating a read-only foreign table.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__sdd0a8602c61a41339b29214e8f4e9fb5"><h4 class="sectiontitle">Syntax</h4><p id="EN-US_TOPIC_0000001233628569__ae4ff17bc34884dd08d5014cf077cdd9a">Create a foreign table,</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__s8c6dc4d7632b4097b35dbf14ec234dec"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">EXISTS</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="k">table_name</span><span class="w"> </span>
<span class="p">(</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="k">column_name</span><span class="w"> </span><span class="n">type_name</span><span class="w"> </span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="p">[</span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="k">constraint_name</span><span class="p">]</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="p">[</span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="k">constraint_name</span><span class="p">]</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="k">NULL</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">column_constraint</span><span class="w"> </span><span class="p">[...]</span><span class="err">}</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="o">|</span>
<span class="w"> </span><span class="n">table_constraint</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="err">}</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span><span class="n">SERVER</span><span class="w"> </span><span class="k">server_name</span><span class="w"> </span>
<span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="err">{</span><span class="w"> </span><span class="n">option_name</span><span class="w"> </span><span class="s1">' value '</span><span class="w"> </span><span class="err">}</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span><span class="w"> </span><span class="p">)</span><span class="w"> </span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="err">{</span><span class="k">WRITE</span><span class="w"> </span><span class="k">ONLY</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">READ</span><span class="w"> </span><span class="k">ONLY</span><span class="err">}</span><span class="p">]</span>
<span class="w"> </span><span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="err">{</span><span class="n">ROUNDROBIN</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">REPLICATION</span><span class="err">}</span>
<span class="w"> </span>
<span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="k">column_name</span><span class="w"> </span><span class="p">)</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="n">AUTOMAPPED</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<ul id="EN-US_TOPIC_0000001233628569__u053126d70fa5495ab77e5da8b4fc1958"><li id="EN-US_TOPIC_0000001233628569__l517e820425434a3cbf67b76d22fd9136"><strong id="EN-US_TOPIC_0000001233628569__b8423527069598">column_constraint</strong> is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__s941b787cdae84046b7e11aa30a3d629e"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">[</span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="k">constraint_name</span><span class="p">]</span>
<span class="err">{</span><span class="k">PRIMARY</span><span class="w"> </span><span class="k">KEY</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">UNIQUE</span><span class="err">}</span>
<span class="p">[</span><span class="k">NOT</span><span class="w"> </span><span class="n">ENFORCED</span><span class="w"> </span><span class="p">[</span><span class="n">ENABLE</span><span class="w"> </span><span class="n">QUERY</span><span class="w"> </span><span class="n">OPTIMIZATION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">DISABLE</span><span class="w"> </span><span class="n">QUERY</span><span class="w"> </span><span class="n">OPTIMIZATION</span><span class="p">]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">ENFORCED</span><span class="p">]</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__led9fec87d69d430f9044b8a42810c3a2"><strong id="EN-US_TOPIC_0000001233628569__b84235270695921">table_constraint</strong> is as follows:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__s95c93b7aa3cb42228b3d297ac8f03598"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><span class="p">[</span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="k">constraint_name</span><span class="p">]</span>
<span class="err">{</span><span class="k">PRIMARY</span><span class="w"> </span><span class="k">KEY</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="k">UNIQUE</span><span class="err">}</span><span class="w"> </span><span class="p">(</span><span class="k">column_name</span><span class="p">)</span>
<span class="p">[</span><span class="k">NOT</span><span class="w"> </span><span class="n">ENFORCED</span><span class="w"> </span><span class="p">[</span><span class="n">ENABLE</span><span class="w"> </span><span class="n">QUERY</span><span class="w"> </span><span class="n">OPTIMIZATION</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">DISABLE</span><span class="w"> </span><span class="n">QUERY</span><span class="w"> </span><span class="n">OPTIMIZATION</span><span class="p">]</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">ENFORCED</span><span class="p">]</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__s755e54aa01f04a4bb44806bedcebdab4"><a name="EN-US_TOPIC_0000001233628569__s755e54aa01f04a4bb44806bedcebdab4"></a><a name="s755e54aa01f04a4bb44806bedcebdab4"></a><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001233628569__uc967ca7573fa4facb27737b572512573"><li id="EN-US_TOPIC_0000001233628569__l4d281c90f2c24d5bb115a5c4c72678ef"><strong id="EN-US_TOPIC_0000001233628569__adaf7361d9a404b8ba23a7b2c8763d92a">IF NOT EXISTS</strong><p id="EN-US_TOPIC_0000001233628569__aa0b742fb82974ebcb3be3ca5e6e7da9e">Does not throw an error if a table with the same name exists. A notice is issued in this case.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l1ea8d0de6a4b4022a4fa2edf217c91be"><strong id="EN-US_TOPIC_0000001233628569__adeb14dc538584f259d8f972d407b3d64">table_name</strong><p id="EN-US_TOPIC_0000001233628569__a30489e2afb9040c2842b5c98e5d73e06">Specifies the name of the foreign table to be created.</p>
<p id="EN-US_TOPIC_0000001233628569__ae253f876725d443ba12939a7634dc9f5">Value range: a string. It must comply with the naming convention.</p>
</li><li id="EN-US_TOPIC_0000001233628569__la062b05736744795aabaab2df2968a1d"><strong id="EN-US_TOPIC_0000001233628569__ac5a44e2804e340548d22494b1981446b">column_name</strong><p id="EN-US_TOPIC_0000001233628569__ae7401cc4f68d41b1a557a3125a45abb7">Specifies the name of a column in the foreign table. Columns are separated by commas (,).</p>
<p id="EN-US_TOPIC_0000001233628569__a58d44cce71c74df49aa96b4fbd0998d4">Value range: a string. It must comply with the naming convention.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note861261818353"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p620954617569">A JSON object consists of nested or parallel name-value pairs, which are irrelevant to the sequence. When data in JSON format is imported, the mapping between fields and values is determined based on the automatic mapping between field names and names of name-value pairs. You need to define proper field names. Otherwise, you may not get the expected result. The rules for automatic mapping between field names and names of name-value pairs are as follows:</p>
<ul id="EN-US_TOPIC_0000001233628569__ul1284735192814"><li id="EN-US_TOPIC_0000001233628569__li182841735202810">If there are no nesting or arrays, the field names must be the same as the names of name-value pairs, case insensitive.</li><li id="EN-US_TOPIC_0000001233628569__li172841535202817">Use underscores (_) to concatenate two names to identify the nesting relationship.</li><li id="EN-US_TOPIC_0000001233628569__li10285835112811">A field name uses the number sign (#) and a decimal non-negative integer (n) to identify the nth element (starting from 0) of an array.</li></ul>
<p id="EN-US_TOPIC_0000001233628569__p66173387549">For example, to import each element of the <strong id="EN-US_TOPIC_0000001233628569__b1024033352813">{"A": "simple", "B": {"C": "nesting"}, "D": ["array", 2, {"E": "complicated"}]}</strong> object, the field names in the foreign table must be defined as <strong id="EN-US_TOPIC_0000001233628569__b6246143312813">a</strong>, <strong id="EN-US_TOPIC_0000001233628569__b4246193362815">b</strong>, <strong id="EN-US_TOPIC_0000001233628569__b3246233192813">b_c</strong>, <strong id="EN-US_TOPIC_0000001233628569__b224683313283">d</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1247173342816">d#0</strong>, <strong id="EN-US_TOPIC_0000001233628569__b624703362812">d#1</strong>,<strong id="EN-US_TOPIC_0000001233628569__b16247153315288"> d#2</strong> and <strong id="EN-US_TOPIC_0000001233628569__b152471533132812">d#2_e</strong>. The sequence in which the fields are defined does not affect the import result.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l3c272b5daca340c1808defda982e7547"><strong id="EN-US_TOPIC_0000001233628569__a1aeb896fdb8b40fe9e69ddb9b8e37f03">type_name</strong><p id="EN-US_TOPIC_0000001233628569__ad21c43f88e02463e96357fe005c391ad">Specifies the data type of the column.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l3599b95737ae496b98971ab5ba81440d"><strong id="EN-US_TOPIC_0000001233628569__a89eeda8c97224f18a130a48352cdd759">constraint_name</strong><p id="EN-US_TOPIC_0000001233628569__a6ea21a1ed7f34ed0828da917f0d0f6d0">Specifies the name of a constraint for the foreign table.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l5ff1ab0b7da249fea4c3a4a0ec3347ee"><strong id="EN-US_TOPIC_0000001233628569__a5cf6fc76bb764e5bb58b4d5f4aa90234">{ NULL | NOT NULL }</strong><p id="EN-US_TOPIC_0000001233628569__ae79118e371964a20b92f8bf407673799">Specifies whether the column allows <strong id="EN-US_TOPIC_0000001233628569__b842352706163617">NULL</strong>.</p>
<p id="EN-US_TOPIC_0000001233628569__a72a269ce121248859f9319629cb78cdc">When you create a table, whether the data in HDFS is <strong id="EN-US_TOPIC_0000001233628569__b842352706163625">NULL</strong> or <strong id="EN-US_TOPIC_0000001233628569__b1747550851164025">NOT NULL</strong> cannot be guaranteed. The consistency of data is guaranteed by users. Users must decide whether the column is <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966095_b842352706163632">NULL</strong> or <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966095_b842352706163634">NOT NULL</strong>. (The optimizer optimizes the <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966095_b842352706163642">NULL/NOT NULL</strong> and generates a better plan.)</p>
</li><li id="EN-US_TOPIC_0000001233628569__l024c7c57b0664dc181cfd555eea33404"><strong id="EN-US_TOPIC_0000001233628569__a684e2a6fda5f4971a3f9b26e7f591cc8">SERVER server_name</strong><p id="EN-US_TOPIC_0000001233628569__a3e9ecd8f567142828481ab3755298d66">Specifies the server name of the foreign table. Users can customize its name.</p>
<p id="EN-US_TOPIC_0000001233628569__a652108c361fe453ba6b1023f451fb7c0">Value range: a string indicating an existing server. It must comply with the naming convention.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l79635f466deb41e783b5de1c76673b0e"><strong id="EN-US_TOPIC_0000001233628569__a7d42096996ab44cfbb3c7e82100335ab">OPTIONS ( { option_name ' value ' } [, ...] )</strong><div class="p" id="EN-US_TOPIC_0000001233628569__a9a2e0b7ef7ee45d2b5b0ca470b8bdc5c">Specifies the following parameters for a foreign table:<ul id="EN-US_TOPIC_0000001233628569__u91f6077eeb5345a795d19a1fb8828dc5"><li id="EN-US_TOPIC_0000001233628569__li935424519181">header<p id="EN-US_TOPIC_0000001233628569__p148387194193"><a name="EN-US_TOPIC_0000001233628569__li935424519181"></a><a name="li935424519181"></a>Specifies whether a data file contains a table header. <strong id="EN-US_TOPIC_0000001233628569__b69633271277">header</strong> is available only for CSV files.</p>
<p id="EN-US_TOPIC_0000001233628569__p108957161916">If <strong id="EN-US_TOPIC_0000001233628569__b1743515324713">header</strong> is <strong id="EN-US_TOPIC_0000001233628569__b174368321710">on</strong>, the first row of the data file will be identified as the header and ignored during export. If <strong id="EN-US_TOPIC_0000001233628569__b9560849472">header</strong> is <strong id="EN-US_TOPIC_0000001233628569__b1856174917717">off</strong>, the first row will be identified as a data row.</p>
<p id="EN-US_TOPIC_0000001233628569__p1060295812195">Value range: <strong id="EN-US_TOPIC_0000001233628569__b842352706174916">true</strong>, <strong id="EN-US_TOPIC_0000001233628569__b84235270616240">on</strong>, <strong id="EN-US_TOPIC_0000001233628569__b8423527061633">false</strong>, and <strong id="EN-US_TOPIC_0000001233628569__b842352706174924">off</strong>. The default value is <strong id="EN-US_TOPIC_0000001233628569__b842352706164830">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b84235270616558">off</strong>.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li145911139132115">quote<p id="EN-US_TOPIC_0000001233628569__p1463924382320"><a name="EN-US_TOPIC_0000001233628569__li145911139132115"></a><a name="li145911139132115"></a>Specifies the quotation mark for the CSV format. The default value is a double quotation mark (").</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note1246821519249"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p1542120287245">The <strong id="EN-US_TOPIC_0000001233628569__b1965017314815">quote</strong> value cannot be the same as the <strong id="EN-US_TOPIC_0000001233628569__b36511631688">delimiter</strong> or <strong id="EN-US_TOPIC_0000001233628569__b2065293118811">null</strong> value.</p>
<p id="EN-US_TOPIC_0000001233628569__p191581138142415">The <strong id="EN-US_TOPIC_0000001233628569__b11297144019818">quote</strong> value must be a single-byte character.</p>
<p id="EN-US_TOPIC_0000001233628569__p083119272617">Invisible characters are recommended as <strong id="EN-US_TOPIC_0000001233628569__b156041347103811">quote</strong> values, such as 0x07, 0x08, and 0x1b.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li1070711463260">escape<p id="EN-US_TOPIC_0000001233628569__p76671312710"><a name="EN-US_TOPIC_0000001233628569__li1070711463260"></a><a name="li1070711463260"></a>Specifies an escape character for a CSV file. The value must be a single-byte character.</p>
<p id="EN-US_TOPIC_0000001233628569__p2582172392715">The default value is a double quotation mark ("). If the value is the same as the <strong id="EN-US_TOPIC_0000001233628569__b232818257910">quote</strong> value, it will be replaced with <strong id="EN-US_TOPIC_0000001233628569__b123291825596">\0</strong>.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li151931457104516">location<p id="EN-US_TOPIC_0000001233628569__p139288794612"><a name="EN-US_TOPIC_0000001233628569__li151931457104516"></a><a name="li151931457104516"></a>Specifies the file path on OBS. This is an OBS foreign table parameter. The data sources of multiple buckets are separated by vertical bars (|), for example, <strong id="EN-US_TOPIC_0000001233628569__b1242212339918">LOCATION 'obs://bucket1/folder/ | obs://bucket2/'</strong>. The database scans all objects in the specified folders.</p>
<p id="EN-US_TOPIC_0000001233628569__p187461638124915">When accessing a DLI multi-version table, you do not need to specify the <strong id="EN-US_TOPIC_0000001233628569__b1425919355336">location</strong> parameter.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li22796811255"><strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0085031719_b84235270620558">format</strong>: format of the data source file in the foreign table.<ul id="EN-US_TOPIC_0000001233628569__ul1981151418254"><li id="EN-US_TOPIC_0000001233628569__l0ee5e669469542609ec1dcbd919aaeb5">HDFS read-only foreign tables support ORC, TEXT, JSON, CSV, and Parquet file formats, while the write-only foreign tables support only the ORC file format.</li><li id="EN-US_TOPIC_0000001233628569__li1598141812258">OBS read-only foreign tables support ORC, TEXT, JSON, CSV, CarbonData, and Parquet file formats, while the write-only foreign tables support only the ORC file format.</li></ul>
<div class="note" id="EN-US_TOPIC_0000001233628569__note11152145892719"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p7398340103318">Only JSON objects (embraced in {}) can be imported. JSON arrays (embraced in []) cannot be imported. However, arrays inside a JSON object can be imported.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__ld6049c058e51424c83f2e9b1881f5381"><strong id="EN-US_TOPIC_0000001233628569__b84235270620555">foldername</strong>: The directory of the data source file in the foreign table, that is, the corresponding file directory in HDFS or on OBS. This parameter is mandatory for the write-only foreign table and optional for the read-only foreign table.<p id="EN-US_TOPIC_0000001233628569__p2814535012">When accessing a DLI multi-version table, you do not need to specify the <strong id="EN-US_TOPIC_0000001233628569__b18802125123416">foldername</strong> parameter.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l8bdb9504168944bfbefc42321c01f73f"><strong id="EN-US_TOPIC_0000001233628569__b84235270620655">encoding</strong>: encoding of data source files in foreign tables. The default value is <strong id="EN-US_TOPIC_0000001233628569__b84235270620728">utf8</strong>. This parameter is optional.</li><li id="EN-US_TOPIC_0000001233628569__l6a917938321a4746941f672873006e27"><strong id="EN-US_TOPIC_0000001233628569__b19806103011108">totalrows</strong>: (Optional) estimated number of rows in a table. This parameter is used only for OBS foreign tables. Because OBS may store many files, it is slow to analyze data. This parameter allows you to set an estimated value so that the optimizer can estimate the table size according to the value. Generally, query efficiency is high when the estimated value is close to the actual value.</li><li id="EN-US_TOPIC_0000001233628569__l6bcd4188385941bca4640a515a7de7ad"><strong id="EN-US_TOPIC_0000001233628569__b174491554135614">filenames</strong>: data source files specified in the foreign table. Multiple files are separated by commas (,).<div class="note" id="EN-US_TOPIC_0000001233628569__nf73ab7d7e4b240ef9be2f40085fb4723"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__u670c0f0f67224b90b66a403f15debdcd"><li id="EN-US_TOPIC_0000001233628569__lcb740513b57c40ba821ccde11a440652">You are advised to use the <strong id="EN-US_TOPIC_0000001233628569__b2299165745612">foldername</strong> parameter to specify the location of the data source. For a read-only foreign table, either <strong id="EN-US_TOPIC_0000001233628569__b11304165715567">filenames</strong> or <strong id="EN-US_TOPIC_0000001233628569__b133051857145611">foldername</strong> must be specified. For a write-only foreign table, only <strong id="EN-US_TOPIC_0000001233628569__b17305105717563">foldername</strong> can be specified.</li><li id="EN-US_TOPIC_0000001233628569__l055f09d3d53f4723a6e4424d5dfc1b7e">If <strong id="EN-US_TOPIC_0000001233628569__b82612021143711">foldername</strong> is an absolute directory, it should be enclosed by slashes (/). Multiple paths are separated by commas (,).</li><li id="EN-US_TOPIC_0000001233628569__l9cf782dd0d48490283f698d3554460fa">When you query a partitioned table, data is pruned based on partition information, and data files that meet the requirement are queried. Pruning involves scanning HDFS directory contents many times. Therefore, do not use columns with low repetition as partition column.</li><li id="EN-US_TOPIC_0000001233628569__li449432944513">An OBS read-only foreign table is not supported.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_li99825131592">delimiter<p id="EN-US_TOPIC_0000001233628569__abb97d60448a640f292832b07ee6581f3"><a name="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_li99825131592"></a><a name="en-us_topic_0059778310_li99825131592"></a>Specifies the column delimiter of data, and uses the default delimiter if it is not set. The default delimiter of TEXT is a tab.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__nf96af8e2050445adb17bc9cbc2da8dbc"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ub618dbe3999e4f80bfc5d8903d251c73"><li id="EN-US_TOPIC_0000001233628569__l5092da06491e4b91ab15f303c6187bef">A delimiter cannot be \r or \n.</li><li id="EN-US_TOPIC_0000001233628569__l5689a574ec8c4425ac605a52c6503f7f">A delimiter cannot be the same as the null parameter.</li><li id="EN-US_TOPIC_0000001233628569__l03cd232e1cf3401fbdeb760d2e9dfa1b">A separator cannot contain(\), (.), digits, or letters.</li><li id="EN-US_TOPIC_0000001233628569__lf75fbc26d20c4b5f945905a26d0dfba5">The data length of a single row should be less than 1 GB. A row that has many columns using long delimiters cannot contain much valid data.</li><li id="EN-US_TOPIC_0000001233628569__ldcc2a31d99094332a647dea11c83b400">You are advised to use a multi-character, such as the combination of the dollar sign ($), caret (^), ampersand (&amp;), or invisible characters, such as 0x07, 0x08, and 0x1b as the delimiter.</li><li id="EN-US_TOPIC_0000001233628569__li69084214112"><strong id="EN-US_TOPIC_0000001233628569__b20416132286">delimiter</strong> is available only for TEXT and CSV source data files.</li></ul>
</div></div>
<p id="EN-US_TOPIC_0000001233628569__a352b057b7bef4fabaa5e548748ea340f">Valid value:</p>
<p id="EN-US_TOPIC_0000001233628569__a45aa25a8fe7744dbb1c035ecb8f352fb">The value of <strong id="EN-US_TOPIC_0000001233628569__b84235270618738">delimiter</strong> can be a multi-character delimiter whose length is less than or equal to 10 bytes.</p>
</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_li62201592">eol<p id="EN-US_TOPIC_0000001233628569__ac972f10899ca443c8019167639eb78ea"><a name="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_li62201592"></a><a name="en-us_topic_0059778310_li62201592"></a>Specifies the newline character style of the imported data file.</p>
<p id="EN-US_TOPIC_0000001233628569__a1b0c62fd2c5b48c8846081c1cc472715">Value range: multi-character newline characters within 10 bytes. Common newline characters include <strong id="EN-US_TOPIC_0000001233628569__b162821550142919">\r</strong> (0x0D), <strong id="EN-US_TOPIC_0000001233628569__b202831150202913">\n</strong> (0x0A), and <strong id="EN-US_TOPIC_0000001233628569__b628495015296">\r\n</strong> (0x0D0A). Special newline characters include <strong id="EN-US_TOPIC_0000001233628569__b112841550172917">$</strong> and <strong id="EN-US_TOPIC_0000001233628569__b428525002916">#</strong>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note4822103112229"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul13825143117221"><li id="EN-US_TOPIC_0000001233628569__li8771574226">The <strong id="EN-US_TOPIC_0000001233628569__b139759512313">eol</strong> parameter applies only to TEXT files.</li><li id="EN-US_TOPIC_0000001233628569__li47725710222">The value of the <strong id="EN-US_TOPIC_0000001233628569__b976217953115">eol</strong> parameter cannot be the same as that of <strong id="EN-US_TOPIC_0000001233628569__b77625973119">DELIMITER</strong> or <strong id="EN-US_TOPIC_0000001233628569__b176316973116">NULL</strong>.</li><li id="EN-US_TOPIC_0000001233628569__li1777105742214">The value of the <strong id="EN-US_TOPIC_0000001233628569__b8552121113111">eol</strong> parameter cannot contain digits, letters, or periods (.).</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l23f5b49658fe4a77b126c30aee563507">null<div class="p" id="EN-US_TOPIC_0000001233628569__p13264202365210"><a name="EN-US_TOPIC_0000001233628569__l23f5b49658fe4a77b126c30aee563507"></a><a name="l23f5b49658fe4a77b126c30aee563507"></a>Specifies the string that represents a null value.<div class="note" id="EN-US_TOPIC_0000001233628569__n98805631e263478db49afc9e4133082d"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ud3ea70521bc846eea88c83f40a9a3bc3"><li id="EN-US_TOPIC_0000001233628569__l91d2f11257e44baf936659a848c01769">The null value cannot be \r or \n. The maximum length is 100 characters.</li><li id="EN-US_TOPIC_0000001233628569__l7b02e83353ee40cfa7ff0e5aaaebfa69">The <strong id="EN-US_TOPIC_0000001233628569__b842352706152552">null</strong> parameter cannot be the same as the delimiter.</li><li id="EN-US_TOPIC_0000001233628569__li064144319579"><strong id="EN-US_TOPIC_0000001233628569__b1862317708">null</strong> is available only for TEXT and CSV source data files.</li></ul>
</div></div>
</div>
<p id="EN-US_TOPIC_0000001233628569__ade34c8e1132e409cb53722bb693acc2e">Valid value:</p>
<p id="EN-US_TOPIC_0000001233628569__p11235174212314">The default value is <strong id="EN-US_TOPIC_0000001233628569__b842352706154323">\N</strong> for the TEXT format.</p>
</li><li id="EN-US_TOPIC_0000001233628569__ldb9cda16bf2849678b91826adb3b4c96">noescaping<p id="EN-US_TOPIC_0000001233628569__aee3bfcaed7dc47b0bc1900e467c2e82b"><a name="EN-US_TOPIC_0000001233628569__ldb9cda16bf2849678b91826adb3b4c96"></a><a name="ldb9cda16bf2849678b91826adb3b4c96"></a>Specifies in TEXT format, whether to escape the backslash (\) and its following characters.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__n74f15869f29641b3938e2c9bf33f7311"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__a40ca2ca4be484a3dab8bb768e34b2912"><strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966236_b8423527069341">noescaping</strong> is available only for TEXT source data files.</p>
</div></div>
<p id="EN-US_TOPIC_0000001233628569__a3fed836460b648e18a5d8b8ac7768254">Value range: <strong id="EN-US_TOPIC_0000001233628569__b1443450065">true</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1958787715">on</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1794491915">false</strong>, and <strong id="EN-US_TOPIC_0000001233628569__b370874641">off</strong>. The default value is <strong id="EN-US_TOPIC_0000001233628569__b2134179703">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b883476996">off</strong>.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l4217c10dcb944cc3a68346ad11014331">fill_missing_fields<p id="EN-US_TOPIC_0000001233628569__a31acb0f9baa14f88bb7d6bb90da8960f"><a name="EN-US_TOPIC_0000001233628569__l4217c10dcb944cc3a68346ad11014331"></a><a name="l4217c10dcb944cc3a68346ad11014331"></a>Specifies whether to generate an error message when the last column in a row in the source file is lost during data loading.</p>
<p id="EN-US_TOPIC_0000001233628569__ac40d46180fe94fcfb1025f8ecef31faf">Value range: <strong id="EN-US_TOPIC_0000001233628569__b1425872014">true</strong>, <strong id="EN-US_TOPIC_0000001233628569__b713962083">on</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1688795880">false</strong>, and <strong id="EN-US_TOPIC_0000001233628569__b1831518338">off</strong>. The default value is <strong id="EN-US_TOPIC_0000001233628569__b467103143">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b489523850">off</strong>.</p>
<ul id="EN-US_TOPIC_0000001233628569__udd9a858112d14944bbab71dd1956f14d"><li id="EN-US_TOPIC_0000001233628569__l7b1522bbf0d74cedb6a2e825bf2acf05">If this parameter is set to <strong id="EN-US_TOPIC_0000001233628569__b842352706152217">true</strong> or <strong id="EN-US_TOPIC_0000001233628569__b84235270617247">on</strong> and the last column of a data row in a data source file is lost, the column is replaced with <strong id="EN-US_TOPIC_0000001233628569__b84235270693653">NULL</strong> and no error message will be generated.</li><li id="EN-US_TOPIC_0000001233628569__l41d3b0a290fc4cd3b4a6b745d80d2f58">If this parameter is set to <strong id="EN-US_TOPIC_0000001233628569__b842352706152317">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b842352706172415">off</strong> and the last column is missing, the following error information will be displayed:<pre class="screen" id="EN-US_TOPIC_0000001233628569__s8d72e1f22ff7490ca9812c58c3f51d16">missing data for column "tt"</pre>
</li></ul>
<div class="note" id="EN-US_TOPIC_0000001233628569__note1072210311210"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul18759328318"><li id="EN-US_TOPIC_0000001233628569__li775912243114">Because <strong id="EN-US_TOPIC_0000001233628569__b842352706162723">SELECT COUNT(*)</strong> does not parse columns in TEXT format, it does not report missing columns.</li><li id="EN-US_TOPIC_0000001233628569__li14759162133113"><strong id="EN-US_TOPIC_0000001233628569__b1980874450">fill_missing_fields</strong> is available only for TEXT and CSV source data files.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l6a63450436114055b9ea51a0174a1886">ignore_extra_data<p id="EN-US_TOPIC_0000001233628569__a5b7b34e1f0ba4efabe5b105e9d33e72c"><a name="EN-US_TOPIC_0000001233628569__l6a63450436114055b9ea51a0174a1886"></a><a name="l6a63450436114055b9ea51a0174a1886"></a>Specifies whether to ignore excessive columns when the number of data source files exceeds the number of foreign table columns. This parameter is available only during data importing.</p>
<p id="EN-US_TOPIC_0000001233628569__a88a05907165c497688e7a79774626883">Value range: <strong id="EN-US_TOPIC_0000001233628569__b1234663614">true</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1050439031">on</strong>, <strong id="EN-US_TOPIC_0000001233628569__b1193847648">false</strong>, and <strong id="EN-US_TOPIC_0000001233628569__b876009786">off</strong>. The default value is <strong id="EN-US_TOPIC_0000001233628569__b396907470">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b852821268">off</strong>.</p>
<ul id="EN-US_TOPIC_0000001233628569__ua4aca6dd0fe04eddb5203afe8419fa07"><li id="EN-US_TOPIC_0000001233628569__lb7620f1a1cec45b19d5bfb2b86fa1050">If this parameter is set to <strong id="EN-US_TOPIC_0000001233628569__b84235270617123">true</strong> or <strong id="EN-US_TOPIC_0000001233628569__b842352706171516">on</strong> and the number of data source files exceeds the number of foreign table columns, excessive columns will be ignored.</li><li id="EN-US_TOPIC_0000001233628569__l1b1b3e3e63054f7a919194ff3f048507">If this parameter is set to <strong id="EN-US_TOPIC_0000001233628569__b84235270617130">false</strong> or <strong id="EN-US_TOPIC_0000001233628569__b842352706182758">off</strong> and the number of data source files exceeds the number of foreign table columns, the following error information will be displayed:<pre class="screen" id="EN-US_TOPIC_0000001233628569__s827035191beb4bffbfe333a3c41a827f">extra data after last expected column</pre>
</li></ul>
<div class="notice" id="EN-US_TOPIC_0000001233628569__n6280f8af19974a25bbc48421ebe41001"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="EN-US_TOPIC_0000001233628569__ul260081911018"><li id="EN-US_TOPIC_0000001233628569__li660081910018">If the newline character at the end of the row is lost, setting the parameter to <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966236_b842352706155739">true</strong> will ignore data in the next row.</li><li id="EN-US_TOPIC_0000001233628569__li9525915103114">Because <strong id="EN-US_TOPIC_0000001233628569__b2040906758">SELECT COUNT(*)</strong> does not parse columns in TEXT format, it does not report missing columns.</li><li id="EN-US_TOPIC_0000001233628569__li166007191405"><strong id="EN-US_TOPIC_0000001233628569__b789311765">ignore_extra_data</strong> is available only for TEXT and CSV source data files.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__ldaa7bd53c7974286a205bc80453762ad">date_format<p id="EN-US_TOPIC_0000001233628569__a6ecaddd7df78470796edd8773879df6a"><a name="EN-US_TOPIC_0000001233628569__ldaa7bd53c7974286a205bc80453762ad"></a><a name="ldaa7bd53c7974286a205bc80453762ad"></a>Specifies the DATE format for data import. This syntax is available only for READ ONLY foreign tables.</p>
<p id="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_p596841495210">Value range: any valid DATE value. For details, see <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__n2ae322a0b1104a29bbe228fc4fe93bd5"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul17709162613020"><li id="EN-US_TOPIC_0000001233628569__li1070913267014">If ORACLE is specified as the compatible database, the DATE format is TIMESTAMP. For details, see <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058965600_b84235270617158">timestamp_format</strong> below.</li><li id="EN-US_TOPIC_0000001233628569__li1970915269014"><strong id="EN-US_TOPIC_0000001233628569__b1631802565">date_format</strong> is available only for TEXT and CSV source data files.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l00fa403aef5d42299f2af84f16d3b6cb">time_format<p id="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_p612537510226"><a name="EN-US_TOPIC_0000001233628569__l00fa403aef5d42299f2af84f16d3b6cb"></a><a name="l00fa403aef5d42299f2af84f16d3b6cb"></a>Specifies the TIME format for data import. This syntax is available only for READ ONLY foreign tables.</p>
<p id="EN-US_TOPIC_0000001233628569__a703907b3cbf04e83a9541a31a3ae184f">Value range: a valid TIME value. Time zones cannot be used. For details, see <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note112511356125816"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p1026695619588"><strong id="EN-US_TOPIC_0000001233628569__b189029799">time_format</strong> is available only for TEXT and CSV source data files.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__lc8af1a8e713546a683d2250aa4023a56">timestamp_format<p id="EN-US_TOPIC_0000001233628569__en-us_topic_0059778310_p678944610616"><a name="EN-US_TOPIC_0000001233628569__lc8af1a8e713546a683d2250aa4023a56"></a><a name="lc8af1a8e713546a683d2250aa4023a56"></a>Specifies the TIMESTAMP format for data import. This syntax is available only for READ ONLY foreign tables.</p>
<p id="EN-US_TOPIC_0000001233628569__a4ef04a24caaf4515b0e7eaef6139df24">Value range: any valid TIMESTAMP value. Time zones are not supported. For details, see <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note94381615593"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p143815118596"><strong id="EN-US_TOPIC_0000001233628569__b2029690713">timestamp_format</strong> is available only for TEXT and CSV source data files.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__lb5b21b8fb41f42f3bb91f1e8a2d7977a">smalldatetime_format<p id="EN-US_TOPIC_0000001233628569__a5d4b686db9bf4696a57286917e570209"><a name="EN-US_TOPIC_0000001233628569__lb5b21b8fb41f42f3bb91f1e8a2d7977a"></a><a name="lb5b21b8fb41f42f3bb91f1e8a2d7977a"></a>Specifies the SMALLDATETIME format for data import. This syntax is available only for READ ONLY foreign tables.</p>
<p id="EN-US_TOPIC_0000001233628569__a9403ae614bf040c4af6baedcc58a791d">Value range: a valid SMALLDATETIME value. For details, see <a href="dws_06_0035.html">Date and Time Processing Functions and Operators</a>.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note2970105013586"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p79851450155816"><strong id="EN-US_TOPIC_0000001233628569__b1751451161">smalldatetime_format</strong> is available only for TEXT and CSV source data files.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li1831945420718">dataencoding<p id="EN-US_TOPIC_0000001233628569__p11198153517818"><a name="EN-US_TOPIC_0000001233628569__li1831945420718"></a><a name="li1831945420718"></a>This parameter specifies the data code of the data table to be exported when the database code is different from the data code of the data table. For example, the database code is Latin-1, but the data in the exported data table is in UTF-8 format. This parameter is optional. If this parameter is not specified, the database encoding format is used by default. This syntax is valid only for the write-only HDFS foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p16272113181718">Value range: data code types supported by the database encoding</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note1867518620215"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p66751367215">The <strong id="EN-US_TOPIC_0000001233628569__b62831441151516">dataencoding</strong> parameter is valid only for the ORC-formatted write-only HDFS foreign table.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li1241716511227">filesize<p id="EN-US_TOPIC_0000001233628569__p1141934762310"><a name="EN-US_TOPIC_0000001233628569__li1241716511227"></a><a name="li1241716511227"></a>Specifies the file size of a write-only foreign table. This parameter is optional. If this parameter is not specified, the file size in the distributed file system configuration is used by default. This syntax is available only for the write-only foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p19846742258">Value range: an integer ranging from 1 to 1024</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note32011266415"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p02019268413">The <strong id="EN-US_TOPIC_0000001233628569__b924833310164">filesize</strong> parameter is valid only for the ORC-formatted write-only HDFS foreign table.</p>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li10634202212434">compression<p id="EN-US_TOPIC_0000001233628569__p157219443509"><a name="EN-US_TOPIC_0000001233628569__li10634202212434"></a><a name="li10634202212434"></a>Specifies the compression mode of ORC files. This parameter is optional. This syntax is available only for the write-only foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p1728715317504">Value range: <strong id="EN-US_TOPIC_0000001233628569__b1356810591717">zlib</strong>, <strong id="EN-US_TOPIC_0000001233628569__b461210791716">snappy</strong>, and <strong id="EN-US_TOPIC_0000001233628569__b312481016176">lz4</strong> The default value is <strong id="EN-US_TOPIC_0000001233628569__b16236358131015">snappy</strong>.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li16723183074313">version<p id="EN-US_TOPIC_0000001233628569__p63121479433"><a name="EN-US_TOPIC_0000001233628569__li16723183074313"></a><a name="li16723183074313"></a>Specifies the ORC version number. This parameter is optional. This syntax is available only for the write-only foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p11527451104713">Value range: Only <strong id="EN-US_TOPIC_0000001233628569__b6915155761715">0.12</strong> is supported. The default value is <strong id="EN-US_TOPIC_0000001233628569__b148361858141715">0.12</strong>.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li36701817154314">dli_project_id<p id="EN-US_TOPIC_0000001233628569__p1133274619430"><a name="EN-US_TOPIC_0000001233628569__li36701817154314"></a><a name="li36701817154314"></a>Specifies the project ID corresponding to DLI. You can obtain the project ID from the management console. This parameter is available only when the server type is DLI. This feature is supported only in 8.1.1 or later.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li392403364311">dli_database_name<p id="EN-US_TOPIC_0000001233628569__p0734131054817"><a name="EN-US_TOPIC_0000001233628569__li392403364311"></a><a name="li392403364311"></a>Specifies the name of the database where the DLI multi-version table to be accessed is located. This parameter is available only when the server type is DLI. This feature is supported only in 8.1.1 or later.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li12109398432">dli_table_name<p id="EN-US_TOPIC_0000001233628569__p3404145164819"><a name="EN-US_TOPIC_0000001233628569__li12109398432"></a><a name="li12109398432"></a>Specifies the name of the DLI multi-version table to be accessed. This parameter is available only when the server type is DLI. This feature is supported only in 8.1.1 or later.</p>
</li><li id="EN-US_TOPIC_0000001233628569__li447217213147">checkencoding<p id="EN-US_TOPIC_0000001233628569__p15201758155"><a name="EN-US_TOPIC_0000001233628569__li447217213147"></a><a name="li447217213147"></a>Specifies whether to check the character encoding.</p>
<div class="p" id="EN-US_TOPIC_0000001233628569__p81769340155">Value range: <strong id="EN-US_TOPIC_0000001233628569__b842352706152646">low</strong>, <strong id="EN-US_TOPIC_0000001233628569__b842352706152644">high</strong> The default value is <strong id="EN-US_TOPIC_0000001233628569__b9469102614407">low</strong>.<div class="note" id="EN-US_TOPIC_0000001233628569__note161602451511"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p1416010441513">In TEXT format, the rule of error tolerance for invalid characters imported is as follows:</p>
<ul id="EN-US_TOPIC_0000001233628569__ul1967971215312"><li id="EN-US_TOPIC_0000001233628569__li254122219311"><strong id="EN-US_TOPIC_0000001233628569__b842352706184528">\0</strong> is converted to a space.</li><li id="EN-US_TOPIC_0000001233628569__li666491923113">Other invalid characters are converted to question marks.</li><li id="EN-US_TOPIC_0000001233628569__li967991243119">Setting <strong id="EN-US_TOPIC_0000001233628569__b96503758811134">checkencoding</strong> to <strong id="EN-US_TOPIC_0000001233628569__b28280779311134">low</strong> enables invalid characters toleration. If <strong id="EN-US_TOPIC_0000001233628569__b124421335711134">NULL</strong> and <strong id="EN-US_TOPIC_0000001233628569__b29056806111134">DELIMITER</strong> are set to spaces or question marks (?), errors like "illegal chars conversion may confuse null 0x20" will be displayed, prompting you to modify parameters that may cause confusion and preventing importing errors.</li></ul>
<p id="EN-US_TOPIC_0000001233628569__p359372217357">In ORC format, the rule of error tolerance for invalid characters imported is as follows:</p>
<ul id="EN-US_TOPIC_0000001233628569__ul106011457193119"><li id="EN-US_TOPIC_0000001233628569__li182953213212">If <strong id="EN-US_TOPIC_0000001233628569__b842352706182712">checkencoding</strong> is <strong id="EN-US_TOPIC_0000001233628569__b842352706182720">low</strong>, an imported field containing invalid characters will be replaced with a quotation mark string of the same length.</li><li id="EN-US_TOPIC_0000001233628569__li1760111573314">If <strong id="EN-US_TOPIC_0000001233628569__b842352706183515">checkencoding</strong> is <strong id="EN-US_TOPIC_0000001233628569__b842352706183534">high</strong>, data import stops when an invalid character is detected.</li></ul>
</div></div>
</div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001233628569__ul5740645616"><li id="EN-US_TOPIC_0000001233628569__li137502161971">force_mapping<p id="EN-US_TOPIC_0000001233628569__p875071614710"><a name="EN-US_TOPIC_0000001233628569__li137502161971"></a><a name="li137502161971"></a>Indicates the handling method used when no correct name-value pairs are matched for the foreign table columns in JSON format.</p>
<p id="EN-US_TOPIC_0000001233628569__p147507163720">The value can be <strong id="EN-US_TOPIC_0000001233628569__b12753010590">true</strong> or <strong id="EN-US_TOPIC_0000001233628569__b1975130115916">false</strong>. Default value: <strong id="EN-US_TOPIC_0000001233628569__b842352706115252">true</strong></p>
<ul id="EN-US_TOPIC_0000001233628569__ul675061618720"><li id="EN-US_TOPIC_0000001233628569__li127504161173">If <strong id="EN-US_TOPIC_0000001233628569__b1839813546341">force_mapping</strong> is <strong id="EN-US_TOPIC_0000001233628569__b131711258143415">true</strong>, null is entered in the corresponding column. The meaning of null is the same as that defined in JSON.</li><li id="EN-US_TOPIC_0000001233628569__li678717242181">If <strong id="EN-US_TOPIC_0000001233628569__b186274143815">force_mapping</strong> is <strong id="EN-US_TOPIC_0000001233628569__b757388143816">false</strong>, an error is reported, indicating that the column does not exist.</li></ul>
<div class="note" id="EN-US_TOPIC_0000001233628569__note419318542110"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__p12301171453219">There are no restrictions on JSON objects. While the definition of foreign table fields must comply with GaussDB(DWS) identifier specifications (such as length and character restrictions). Therefore, this import method may cause exceptions. For example, a JSON name cannot be correctly identified or a field is repeatedly defined. You are advised to use the fault tolerance option <strong id="EN-US_TOPIC_0000001233628569__b22354818284">force_mapping</strong> or JSON operators (for details, see <a href="dws_06_0041.html">JSON/JSONB Functions and Operators</a>).</p>
<p id="EN-US_TOPIC_0000001233628569__p680641110325">For JSON format, <strong id="EN-US_TOPIC_0000001233628569__b148311454142819">SELECT COUNT(*)</strong> does not parse specific fields. Therefore, no error is reported when a field is missing or the format is incorrect.</p>
</div></div>
</li></ul>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233628569__table1836190163118" frame="border" border="1" rules="all"><caption><b>Table 1 </b>OBS foreign table options supported by Text, CSV, JSON, ORC, CarbonData, and Parquet formats</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row13713011317"><th align="left" class="cellrowborder" valign="top" id="mcps1.3.4.2.8.4.2.9.1.1"><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p23717053117">Parameter</p>
</th>
<th align="center" class="cellrowborder" colspan="7" valign="top" id="mcps1.3.4.2.8.4.2.9.1.2"><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p103716053116">OBS</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row1371502317"><td class="cellrowborder" rowspan="2" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p10373013313">-</p>
<p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p539120173113"></p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p12371023111">TEXT</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p03890193113">CSV</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12929399419">JSON</p>
</td>
<td class="cellrowborder" colspan="2" align="center" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p19382019311">ORC</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p12381807313">CARBONDATA</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p5504846022">PARQUET</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row63810017313"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p13910016314">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p133911020318">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4293153919417">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p03918016311">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p184090193118">WRITE ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p16406012314">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1750524613217">READ ONLY</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row84150163116"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p5411509312">location</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p14446161751312">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p770563815132">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p8293113954113">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p164190103111">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p29471326171414">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p639462916306">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p13762247123010">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row174370133112"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p10431203311">format</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p25971153181319">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1167005315135">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4293539204118">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1074218539139">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p2819153121313">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p11889853201317">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17762154773018">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row145190153115"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p545407316">header</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p124511063117">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p03201152113">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142931539144110">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1630653101618">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p649915410178">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p118616196176">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p16762194712300">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row20471013118"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p174711053112">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1045316416169">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1813719111215">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p129373910412">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p15707175371610">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p55877410178">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p14164201931716">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12763547153010">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row19481606318"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p2481509317">quote</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p7756102961715">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p102216114214">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p929313917419">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1773753131611">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p2665445178">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p82332019101710">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p10763134715300">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row145019017314"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p35020063116">escape</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p582732931716">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p931016192113">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p5293103984117">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p188451253121619">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1574012401718">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p10305101916171">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1476318471309">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row752110103114"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p552805318">null</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p6532063115">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p114096118215">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p132937399418">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p59167538161">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p128173416171">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p133863194172">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p27639477300">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row5544083114"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p65417073113">noescaping</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1065255041418">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p15543013312">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p929318399415">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1599295319164">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1689794151712">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1465519151718">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p476374773014">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row16561904319"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p656904312">encoding</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1873335001412">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1228582714228">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1293039124110">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1536552716229">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p15444327152216">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p15171627132213">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p147633478308">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row145818023116"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p18586023113">fill_missing_fields</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1880745051419">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p17662113818222">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p20293439174116">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p4304191701812">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p564812351817">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1919193110181">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p576384703013">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row35919063114"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p15605013313">ignore_extra_data</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p4882650101411">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p178081359171418">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1729313914412">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1338581713182">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p9725223191817">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p7101103141812">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p167631547163020">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row16170103114"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1561130143118">date_format</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p895718506144">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p148891559121415">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p92941039134117">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1146318175188">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p97957233185">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p71762031181814">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p6763947103014">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row96217083111"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p19626033115">time_format</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1327151151410">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p119601859161414">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p42941939134111">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p154219179189">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p12876152361810">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p225417319183">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4763134753014">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row1641406313"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p5641706312">timestamp_format</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p6961551141417">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p3723011513">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p10294739114111">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p4618717161811">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p5952162318188">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p03401831161817">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1076434720304">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row176670113113"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p866160123110">smalldatetime_format</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p616615118148">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1017415091518">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p14294103918414">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p136941917171815">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p122532419189">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p842219314187">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p276444711303">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row186840153111"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p146880153114">chunksize</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p20150192013218">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p17232122017213">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2294339114118">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1377912175182">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p7100132461810">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p124961531151820">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p10764104713301">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row66919016316"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p069170183120">filenames</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p27944537193">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1286545391915">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p162941739114113">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p185601781812">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p20173142481820">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p54551352200">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p476424713013">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row47118033113"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1671805318">foldername</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1394591321511">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p112111143159">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p3294539154115">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p2090171431510">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p0159131414153">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p52291014111515">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17764134710304">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row1374190153114"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p17743012311">dataencoding</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p627613212196">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p336212214194">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p229463910414">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p14439172191914">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1414910117199">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p0241131118194">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17764947113013">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row6779015316"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p07710123114">filesize</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p952022151912">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p176051122196">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7294153916416">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1669315241917">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p16313119196">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p47151911131914">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1176424783014">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row147917011319"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p8801033111">compression</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p137817231914">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p888252131913">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7294173934112">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p198117211196">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p5452134619215">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1474481813194">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1876415474301">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row1836010316"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p178318018312">version</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p13814331917">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p717513310199">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p529483910411">×</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p152571435196">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1654516468218">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p837151961917">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p876412477308">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row2851701319"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p88650173115">checkencoding</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p071310300218">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p679111308215">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p192942396415">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p12869173052119">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p39092040191912">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p987194302110">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p0764647103014">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_row8891709313"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p689120113118">totalrows</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p99569305211">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p644163118219">√</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p20295143916418">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p20121143110215">√</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p129761406194">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_p1146544551911">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p57657477308">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row17923127114312"><td class="cellrowborder" valign="top" width="17.575272581774527%" headers="mcps1.3.4.2.8.4.2.9.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1392312911438">force_mapping</p>
</td>
<td class="cellrowborder" valign="top" width="10.533159947984393%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p5923152919435">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.873562068620583%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p179237299433">×</p>
</td>
<td class="cellrowborder" valign="top" width="11.143343002900867%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p592314293437">√</p>
</td>
<td class="cellrowborder" valign="top" width="10.843252975892764%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p592342916439">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.773832149644889%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1192312918433">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.19395818745623%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p092492904311">×</p>
</td>
<td class="cellrowborder" valign="top" width="12.063619085725714%" headers="mcps1.3.4.2.8.4.2.9.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1076564733018">×</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001233628569__table4234184115155" frame="border" border="1" rules="all"><caption><b>Table 2 </b>HDFS foreign table options supported by Text, CSV, JSON, ORC, and Parquet formats</caption><thead align="left"><tr id="EN-US_TOPIC_0000001233628569__row122355417154"><th align="left" class="cellrowborder" valign="top" id="mcps1.3.4.2.8.5.2.8.1.1"><p id="EN-US_TOPIC_0000001233628569__p1923594171510">Parameter</p>
</th>
<th align="center" class="cellrowborder" colspan="6" valign="top" id="mcps1.3.4.2.8.5.2.8.1.2"><p id="EN-US_TOPIC_0000001233628569__p1523684119158">HDFS</p>
</th>
</tr>
</thead>
<tbody><tr id="EN-US_TOPIC_0000001233628569__row7236144131519"><td class="cellrowborder" rowspan="2" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p5236641171513">-</p>
<p id="EN-US_TOPIC_0000001233628569__p20236541121519"></p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p202362041151519">TEXT</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p6236184113154">CSV</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p132231509436">JSON</p>
</td>
<td class="cellrowborder" colspan="2" align="center" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7236104101517">ORC</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p82371941111516">PARQUET</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row4237184113152"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p4237144114154">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p523718417153">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p192232084311">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p42371441101514">READ ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p192377411151">WRITE ONLY</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p823754141515">READ ONLY</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row18237441181519"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1923811416152">location</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p10238154121518">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p9238134141519">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p22231104434">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p223844118155">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1823844118159">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1923814418159">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row62381141161519"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1323974101514">format</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p92398417155">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17239241141515">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p152238094317">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p9239104131511">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2239241141511">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p823914191518">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row8239441111510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1023934119157">header</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p924016417158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1724084112159">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p42235014439">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p624034114152">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p324054112157">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1240134161510">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row7240164112156"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1124019414158">delimiter</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12241134141514">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p824174113151">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p82231302434">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p524154110159">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1524184101510">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p18241104131517">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row1224116414158"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1424112411152">quote</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p82421741141511">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p3242194119158">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p18223170124315">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1524219411152">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4242114111152">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p6242641101519">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row32424415159"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p92421241191518">escape</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1824312412152">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p11243141101517">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p112239011435">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4243114151514">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p19243104131520">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1524315419152">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row17243144141510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p112431441101513">null</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p424434171518">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7244941111511">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142232005435">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12244341201513">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p42443418156">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p132448416151">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row16244154113152"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p192441041171518">noescaping</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p524510417155">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p724512417158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1722311084316">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p152453417158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1245124112158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p5245194161518">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row172451641181513"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p182458418155">encoding</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p14246741131514">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142462411152">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12231012439">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7246941141510">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p14246144181513">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p52461541161514">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row16246134111516"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p112461641181517">fill_missing_fields</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p724704131512">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p192471341121513">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p52242044319">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17247144112154">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p0247104114156">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p124720414158">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row9247194151510"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p162471641171513">ignore_extra_data</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p102488419154">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1424824131514">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1922413024316">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2248194151518">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4248194116150">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2248184191517">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row20248104112152"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1248441191516">date_format</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p16249114111513">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1724919414159">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1622416074318">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p225074118154">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p02501411159">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p8250144151515">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row1125064114156"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p152501641191517">time_format</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1425118417151">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p0251174111157">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p82247024319">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p9251174114155">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p6251341141518">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p62517415156">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row11251194114158"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p132511141181515">timestamp_format</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p16252184119158">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12252041131514">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p14224130174315">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p112523414153">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p12252841101517">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1325313411152">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row1725344171520"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p225317413154">smalldatetime_format</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p62537414154">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1125315416157">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p162245064318">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p5254441141513">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p4254194115153">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p15254184115151">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row14254194161514"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p62541441151512">chunksize</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p16254184119151">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1725519419152">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p922490144312">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17255204151518">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p8255164113159">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1525544113158">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row10255941111517"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1625534117157">filenames</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p92561941131512">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p82569414150">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p622430204314">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p3256141131518">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p16256144121512">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2025615411152">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row525644111152"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p1525604151516">foldername</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p625724161516">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p7257154119151">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p162241709436">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p102571441141510">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p10257104114152">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p725724141514">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row16260154191514"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p6260134118158">dataencoding</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1126114161520">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p17261941151510">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142244024311">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p112610412150">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p162614413158">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1026114191519">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row226174111151"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p526124117157">filesize</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p52623411158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1726364171511">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p162241803439">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p726344115150">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1126344112151">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p102633414159">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row2026394181515"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p13263104111513">compression</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p13264441171515">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p6264154112159">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1224190134314">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p42641541191516">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p132651841151518">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p182651410153">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row1526594114150"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p426584113159">version</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p8266164115156">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p2266134118158">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1922480114311">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p326634161516">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p326617416153">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1926610414155">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row1226654115154"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p102661441191513">checkencoding</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p926764112156">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p152672415153">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142244011434">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142671241141518">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p13267154120152">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p142671841201510">√</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row0267114113150"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p3267441151519">totalrows</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p9268114110156">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p3268144171515">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p822510064318">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p126804113152">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1926824112157">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p122681741161515">×</p>
</td>
</tr>
<tr id="EN-US_TOPIC_0000001233628569__row19160162193010"><td class="cellrowborder" valign="top" width="19%" headers="mcps1.3.4.2.8.5.2.8.1.1 "><p id="EN-US_TOPIC_0000001233628569__p16161521173010">force_mapping</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p516122153020">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p016119219308">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p1225708438">√</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p91611521133017">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p716114214307">×</p>
</td>
<td class="cellrowborder" valign="top" width="13.5%" headers="mcps1.3.4.2.8.5.2.8.1.2 "><p id="EN-US_TOPIC_0000001233628569__p416142113304">×</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li485812845110">WRITE ONLY | READ ONLY<p id="EN-US_TOPIC_0000001233628569__p10698131516522"><a name="EN-US_TOPIC_0000001233628569__li485812845110"></a><a name="li485812845110"></a><strong id="EN-US_TOPIC_0000001233628569__b8602114914186">WRITE ONLY</strong> creates a write-only HDFS/OBS foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p15487183155817"><strong id="EN-US_TOPIC_0000001233628569__b09407619195">READ ONLY</strong> creates a read-only HDFS/OBS foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__p1121133420569">If the foreign table type is not specified, a read-only foreign table is created by default.</p>
</li><li id="EN-US_TOPIC_0000001233628569__la882da19e7814a53bcc13879e1cb9808"><strong id="EN-US_TOPIC_0000001233628569__a1a69dfd002ff443ea0593c5223b08e03">DISTRIBUTE BY ROUNDROBIN</strong><p id="EN-US_TOPIC_0000001233628569__a20498deb2c7e44c295af99382adb8156">Specifies <strong id="EN-US_TOPIC_0000001233628569__b713760207201549">ROUNDROBIN</strong> as the distribution mode for the HDFS/OBS foreign table.</p>
</li><li id="EN-US_TOPIC_0000001233628569__le77c75cc2bf343f599a019fc92b81f2a"><strong id="EN-US_TOPIC_0000001233628569__a0eec7b61dec744ea894d876ca27142bb">DISTRIBUTE BY REPLICATION</strong><p id="EN-US_TOPIC_0000001233628569__a520196a91ca7464b878b7cd76e598ef1">Specifies <strong id="EN-US_TOPIC_0000001233628569__b1314189711201636">REPLICATION</strong> as the distribution mode for the HDFS foreign table.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l222af02565a04384b5895e2e8f4a35b6"><strong id="EN-US_TOPIC_0000001233628569__a17818bfaeddc4cda9a93b350199255cf">PARTITION BY ( column_name ) AUTOMAPPED</strong><p id="EN-US_TOPIC_0000001233628569__aef1a82bdbe904610b10ed292955443fe"><strong id="EN-US_TOPIC_0000001233628569__b842352706154437">column_name</strong> specifies the partition column. <strong id="EN-US_TOPIC_0000001233628569__b842352706163816">AUTOMAPPED</strong> means the partition column specified by the HDFS partitioned foreign table is automatically mapped with the partition directory information in HDFS. The prerequisite is that the sequences of partition columns specified in the HDFS foreign table and in the directory are the same. This function is applicable only to read-only foreign tables.</p>
<div class="note" id="EN-US_TOPIC_0000001233628569__note6231111574913"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul10233141311510"><li id="EN-US_TOPIC_0000001233628569__li22334132513">HDFS read-only and write-only foreign tables support partitioned tables. However, write-only foreign tables support only primary partitions and do not support multi-level partitions.</li><li id="EN-US_TOPIC_0000001233628569__li123341319516">Partitioned tables can be used as read-only foreign tables for OBS.</li><li id="EN-US_TOPIC_0000001233628569__li093026143018">Columns of the floating point or Boolean type cannot be used as partition columns.</li><li id="EN-US_TOPIC_0000001233628569__li17220134373410">The maximum length of a partition field can be specified by the GUC parameter <strong id="EN-US_TOPIC_0000001233628569__b3965623131710">dfs_partition_directory_length</strong>.</li><li id="EN-US_TOPIC_0000001233628569__li139732039103220">A partition directory name is in the format <em id="EN-US_TOPIC_0000001233628569__i956982518176">Partition column name</em><strong id="EN-US_TOPIC_0000001233628569__b756972514172">=</strong><em id="EN-US_TOPIC_0000001233628569__i9570122510175">Partition column value</em>. Any special characters in the name will be escaped. It is recommended that the name length before escaping be less than or equal to (<strong id="EN-US_TOPIC_0000001233628569__b766017322176">dfs_partition_directory_length</strong> + 1)/3, so that the total length of the name after escaping will not exceed <strong id="EN-US_TOPIC_0000001233628569__b20661732171710">dfs_partition_directory_length</strong>.</li><li id="EN-US_TOPIC_0000001233628569__li486655314309">Do not use a column containing too many Chinese characters as a partition column. Chinese and English characters have different space usage. If Chinese partition columns are used, it will be difficult to calculate the length of the final partition directory name, which is more likely to exceed the limit specified by <strong id="EN-US_TOPIC_0000001233628569__b054053716171">dfs_partition_directory_length</strong>.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l63922e7b7eab4f2cb6420185423d9a24"><strong id="EN-US_TOPIC_0000001233628569__a0e619e06c4e542eb906302c8bc9842f0">CONSTRAINT constraint_name</strong><p id="EN-US_TOPIC_0000001233628569__a10cbf630d2384c2cb8fe3722a39d8f9e">Specifies the name of informational constraint of the foreign table.</p>
<p id="EN-US_TOPIC_0000001233628569__a98357ece58214d3a934610e81e5cddd4">Value range: a string. It must comply with the naming convention.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l10c26d6bf2d64e2c9f3e79a03ebc0390"><strong id="EN-US_TOPIC_0000001233628569__a5e526c69dacb412cb867c855a94915ec">PRIMARY KEY</strong><p id="EN-US_TOPIC_0000001233628569__ac3596e1da57b428a989c700af279a537">The primary key constraint specifies that one or more columns of a table must contain unique (non-duplicate) and non-null values. Only one primary key can be specified for a table.</p>
</li><li id="EN-US_TOPIC_0000001233628569__le12ef1bffb1045e3bea703fc0d569440"><strong id="EN-US_TOPIC_0000001233628569__a86489a9898fd49499b9b72f69cdb63ee">UNIQUE</strong><p id="EN-US_TOPIC_0000001233628569__a96d564d36c244aac82451d76d0bd1d2d">Specifies that a group of one or more columns of a table must contain unique values. For the purpose of a unique constraint, <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058965796_b842352706104755">NULL</strong> is not considered equal.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l53f3e62aef4d485dbea666348b879d92"><strong id="EN-US_TOPIC_0000001233628569__a55f97ec27b434368a898cef34e37e76a">NOT ENFORCED</strong><p id="EN-US_TOPIC_0000001233628569__afceaa793b7a048839870f3ffb44d0999">Specifies the constraint to be an informational constraint. This constraint is guaranteed by the user instead of the database.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l241fad9545e6452a83073cd90ee65111"><strong id="EN-US_TOPIC_0000001233628569__ae23916112a1a4ecbabb5c7b87c2c551b">ENFORCED</strong><p id="EN-US_TOPIC_0000001233628569__abdc77143a75745fcb9bee33387bcd3cf">The default value is <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966095_b84235270610317">ENFORCED</strong>. <strong id="EN-US_TOPIC_0000001233628569__b1086465600202141">ENFORCED</strong> is a reserved parameter and is currently not supported.</p>
</li><li id="EN-US_TOPIC_0000001233628569__le721dc93b0434454ba0efa6f93d3ea3c"><strong id="EN-US_TOPIC_0000001233628569__a0a6d969126f54404a61b2ecd6cc741db">PRIMARY KEY (column_name)</strong><p id="EN-US_TOPIC_0000001233628569__a6e424d2054824bd3b4ea45619d81c764">Specifies the informational constraint on <strong id="EN-US_TOPIC_0000001233628569__b842352706163930">column_name</strong>.</p>
<p id="EN-US_TOPIC_0000001233628569__a90fdf7ef20f94350b074e6edb1118952">Value range: a string. It must comply with the naming convention, and the value of <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0058966095_b842352706102528">column_name</strong> must exist.</p>
</li><li id="EN-US_TOPIC_0000001233628569__lc8734888be2346e6b315018a0b7c7923"><strong id="EN-US_TOPIC_0000001233628569__a0b7ba6d87d914c02b63268dc3455af24">ENABLE QUERY OPTIMIZATION</strong><p id="EN-US_TOPIC_0000001233628569__a2d615fbb44be46389ce100ea74c6e223">Optimizes an execution plan using an informational constraint.</p>
</li><li id="EN-US_TOPIC_0000001233628569__l00d2566316d644ea90323dc2dd1e31c9"><strong id="EN-US_TOPIC_0000001233628569__ae0d3187d6d2c494b8e944c02664e00b2">DISABLE QUERY OPTIMIZATION</strong><p id="EN-US_TOPIC_0000001233628569__a0c5870c38c614d52809784bb531cc9f0">Disables the optimization of an execution plan using an informational constraint.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__s0b7a85d0acff48e79ada2f91d1e79a0f"><a name="EN-US_TOPIC_0000001233628569__s0b7a85d0acff48e79ada2f91d1e79a0f"></a><a name="s0b7a85d0acff48e79ada2f91d1e79a0f"></a><h4 class="sectiontitle">Informational Constraint</h4><p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_a56ae2d110488441fb9a0809b8d86664a">In <span id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_text464317611">GaussDB(DWS)</span>, the use of data constraints depend on users. If users can make data sources strictly comply with certain constraints, the query on data with such constraints can be accelerated. Foreign tables do not support Index. Informational constraint is used for optimizing query plans.</p>
<p id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_a47363cf5c0a94644ae6490f2a113cf79"><strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_en-us_topic_0059779123_en-us_topic_0058966095_b314165859127">The constraints of creating informational constraints for a foreign table are as follows:</strong></p>
<ul id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_u39570fd8db174d0b9830dbe6f54b20d4"><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_l0d366a040a9b430c885fe43cce666d37">You can create an informational constraint only if the values in a NOT NULL column in your table are unique. Otherwise, the query result will be different from expected.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_l7cf828fc11c2447e94a9b663597049dd">Currently, the informational constraint of <span id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_text1794844599">GaussDB(DWS)</span> supports only PRIMARY KEY and UNIQUE constraints.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_la8aea369c8614e5ab3965eac4dd69b15">The informational constraints of <span id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_text924257475">GaussDB(DWS)</span> support the NOT ENFORCED attribute.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_lf3d892eee0b94559ba69eaa0a95e560c">UNIQUE informational constraints can be created for multiple columns in a table, but only one PRIMARY KEY constraint can be created in a table.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_la21a34fe1c7a4a2d9f949cbf7c371c9b">Multiple informational constraints can be established in a column of a table (because the function that establishing a column or multiple constraints in a column is the same.) Therefore, you are not advised to set up multiple informational constraints in a column, and only one Primary Key type can be set up.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_l2e172cd71cf24e699871c42b27944fb9">Multi-column combination constraints are not supported.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_li537213701617">Different CNs in the same cluster cannot concurrently export data to the same write-only ORC foreign table.</li><li id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_li10645209161916">The catalog of a write-only foreign table in ORC format can only be used as the export catalog of a single foreign table of <span id="EN-US_TOPIC_0000001233628569__en-us_topic_0000001145830873_text1611334743">GaussDB(DWS)</span>. It cannot be used for multiple foreign tables, and other components cannot write other files to this catalog.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__s07885a43a93744359b82400d0a8873b3"><h4 class="sectiontitle">Example 1</h4><p id="EN-US_TOPIC_0000001233628569__ac48b7a35e4454639a484042c4f6ac397">Example 1: In HDFS, import the TPC-H benchmark test tables <strong id="EN-US_TOPIC_0000001233628569__b84235270614240">part</strong> and <strong id="EN-US_TOPIC_0000001233628569__b84235270614246">region</strong> using Hive. The path of the <strong id="EN-US_TOPIC_0000001233628569__b842352706163847">part</strong> table is <strong id="EN-US_TOPIC_0000001233628569__b842352706184740">/user/hive/warehouse/partition.db/part_4</strong>, and that of the <strong id="EN-US_TOPIC_0000001233628569__b842352706163842">region</strong> table is <strong id="EN-US_TOPIC_0000001233628569__b842352706184745">/user/hive/warehouse/gauss.db/region_orc11_64stripe/</strong>.</p>
<ol id="EN-US_TOPIC_0000001233628569__ol1590410430712"><li id="EN-US_TOPIC_0000001233628569__li390413437714">Establish HDFS_Server, with HDFS_FDW or DFS_FDW as the foreign data wrapper.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__s0211efd2605f4c1b9bc7189580006ca8"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="n">SERVER</span><span class="w"> </span><span class="n">hdfs_server</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">DATA</span><span class="w"> </span><span class="n">WRAPPER</span><span class="w"> </span><span class="n">HDFS_FDW</span><span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span><span class="n">address</span><span class="w"> </span><span class="s1">'10.10.0.100:25000,10.10.0.101:25000'</span><span class="p">,</span><span class="n">hdfscfgpath</span><span class="w"> </span><span class="s1">'/opt/hadoop_client/HDFS/hadoop/etc/hadoop'</span><span class="p">,</span><span class="k">type</span><span class="s1">'HDFS'</span><span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001233628569__n5f57b19875be47c2ae24286f1987e766"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul10547638129"><li id="EN-US_TOPIC_0000001233628569__li35471381216">The IP addresses and port numbers of HDFS NameNodes are specified in <strong id="EN-US_TOPIC_0000001233628569__b101281931204013">OPTIONS</strong>. For details about the port number, search for <strong id="EN-US_TOPIC_0000001233628569__b11993220409">dfs.namenode.rpc.port</strong> in the MRS-HDFS service configuration. In this example the port number is 25000.</li><li id="EN-US_TOPIC_0000001233628569__li6516449218"><strong id="EN-US_TOPIC_0000001233628569__b10366183484019">10.10.0.100:25000,10.10.0.101:25000</strong> indicates the IP addresses and port numbers of the primary and standby HDFS NameNodes. It is the recommended format. Two groups of parameters are separated by commas (,).</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li193772221987">Create an HDFS foreign table. The HDFS server associated with the table is <strong id="EN-US_TOPIC_0000001233628569__b432943805013">hdfs_server</strong>, the corresponding file format of the <strong id="EN-US_TOPIC_0000001233628569__b10330103875010">ft_region</strong> table on the HDFS server is <strong id="EN-US_TOPIC_0000001233628569__b11330193812505">'orc'</strong>, and the file directory in the HDFS file system is <strong id="EN-US_TOPIC_0000001233628569__b933114382502">'/user/hive/warehouse/gauss.db/region_orc11_64stripe/'</strong>.<ul id="EN-US_TOPIC_0000001233628569__ul16944175214918"><li id="EN-US_TOPIC_0000001233628569__li17945125216919">Create an HDFS foreign table without partition keys.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__sd926eb1a47c646f089d22960d0e4bfaf"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">DROP</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="k">IF</span><span class="w"> </span><span class="k">EXISTS</span><span class="w"> </span><span class="n">ft_region</span><span class="p">;</span>
<span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">R_REGIONKEY</span><span class="w"> </span><span class="n">INT4</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_NAME</span><span class="w"> </span><span class="nb">TEXT</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_COMMENT</span><span class="w"> </span><span class="nb">TEXT</span>
<span class="p">)</span>
<span class="n">SERVER</span>
<span class="w"> </span><span class="n">hdfs_server</span>
<span class="k">OPTIONS</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">FORMAT</span><span class="w"> </span><span class="s1">'orc'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">FOLDERNAME</span><span class="w"> </span><span class="s1">'/user/hive/warehouse/gauss.db/region_orc11_64stripe/'</span>
<span class="p">)</span>
<span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span>
<span class="w"> </span><span class="n">roundrobin</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li1911092411116">Create an HDFS foreign table with partition keys.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen8876891101"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_part</span><span class="w"> </span>
<span class="p">(</span>
<span class="w"> </span><span class="n">p_partkey</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_name</span><span class="w"> </span><span class="nb">text</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_mfgr</span><span class="w"> </span><span class="nb">text</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_brand</span><span class="w"> </span><span class="nb">text</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_type</span><span class="w"> </span><span class="nb">text</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_size</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_container</span><span class="w"> </span><span class="nb">text</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_retailprice</span><span class="w"> </span><span class="n">float8</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">p_comment</span><span class="w"> </span><span class="nb">text</span>
<span class="p">)</span>
<span class="n">SERVER</span>
<span class="w"> </span><span class="n">hdfs_server</span>
<span class="k">OPTIONS</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">FORMAT</span><span class="w"> </span><span class="s1">'orc'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">FOLDERNAME</span><span class="w"> </span><span class="s1">'/user/hive/warehouse/partition.db/part_4'</span>
<span class="p">)</span>
<span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span>
<span class="w"> </span><span class="n">roundrobin</span>
<span class="n">PARTITION</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span>
<span class="w"> </span><span class="p">(</span><span class="n">p_mfgr</span><span class="p">)</span><span class="w"> </span><span class="n">AUTOMAPPED</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001233628569__nd98a0d7e2b644575aaf02c6ad7ee1dd6"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001233628569__a7867aa29296b49cc9e6c0fdd3a6d4adb"><span id="EN-US_TOPIC_0000001233628569__text959103452">GaussDB(DWS)</span> allows you to specify files using the keyword <strong id="EN-US_TOPIC_0000001233628569__b842352706185749">filenames</strong> or <strong id="EN-US_TOPIC_0000001233628569__b842352706185754">foldername</strong>. The latter is recommended. The key word <strong id="EN-US_TOPIC_0000001233628569__b842352706185825">distribute</strong> specifies the storage distribution mode of the <strong id="EN-US_TOPIC_0000001233628569__b1692112463299">ft_region</strong> table.</p>
</div></div>
</li></ul>
</li><li id="EN-US_TOPIC_0000001233628569__li84251710201210">View the created server and foreign table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__sb1ab13e6c6624d8b9115ccfa7a481f9e"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_foreign_table</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">ftrelid</span><span class="o">=</span><span class="s1">'ft_region'</span><span class="p">::</span><span class="n">regclass</span><span class="p">;</span>
<span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_foreign_table</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">ftrelid</span><span class="o">=</span><span class="s1">'ft_part'</span><span class="p">::</span><span class="n">regclass</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__section1836183181319"><h4 class="sectiontitle">Example 2</h4><p id="EN-US_TOPIC_0000001233628569__p8108191892017">Export data from the TPC-H benchmark test table region table to the <strong id="EN-US_TOPIC_0000001233628569__b32401504517">/user/hive/warehouse/gauss.db/regin_orc/</strong> directory of the HDFS file system through the HDFS write-only foreign table.</p>
<ol id="EN-US_TOPIC_0000001233628569__ol858020203204"><li id="EN-US_TOPIC_0000001233628569__li11402182672017">Create an HDFS foreign table. The corresponding foreign data wrapper is <strong id="EN-US_TOPIC_0000001233628569__b119666113519">HDFS_FDW</strong> or <strong id="EN-US_TOPIC_0000001233628569__b49661115118">DFS_FDW</strong>, which is the same as that in Example 1.</li><li id="EN-US_TOPIC_0000001233628569__li058082011204">Create a write-only HDFS foreign table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen8143121854913"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_wo_region</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">R_REGIONKEY</span><span class="w"> </span><span class="n">INT4</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_NAME</span><span class="w"> </span><span class="nb">TEXT</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_COMMENT</span><span class="w"> </span><span class="nb">TEXT</span>
<span class="p">)</span>
<span class="n">SERVER</span>
<span class="w"> </span><span class="n">hdfs_server</span>
<span class="k">OPTIONS</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">FORMAT</span><span class="w"> </span><span class="s1">'orc'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">FOLDERNAME</span><span class="w"> </span><span class="s1">'/user/hive/warehouse/gauss.db/regin_orc/'</span>
<span class="p">)</span>
<span class="k">WRITE</span><span class="w"> </span><span class="k">ONLY</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li111351550162112">Writes data to the HDFS file system through a write-only foreign table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen13301192565316"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">INSERT</span><span class="w"> </span><span class="k">INTO</span><span class="w"> </span><span class="n">ft_wo_region</span><span class="w"> </span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">region</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__section1350434851317"><h4 class="sectiontitle">Example 3</h4><p id="EN-US_TOPIC_0000001233628569__p114201518102211">Perform operations on an HDFS foreign table that includes informational constraints.</p>
<ul id="EN-US_TOPIC_0000001233628569__ul1189011022318"><li id="EN-US_TOPIC_0000001233628569__li889010072316">Create an HDFS foreign table with informational constraints.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen51753013232"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">R_REGIONKEY</span><span class="w"> </span><span class="nb">int</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_NAME</span><span class="w"> </span><span class="nb">TEXT</span><span class="p">,</span>
<span class="w"> </span><span class="n">R_COMMENT</span><span class="w"> </span><span class="nb">TEXT</span>
<span class="w"> </span><span class="p">,</span><span class="w"> </span><span class="k">primary</span><span class="w"> </span><span class="k">key</span><span class="w"> </span><span class="p">(</span><span class="n">R_REGIONKEY</span><span class="p">)</span><span class="w"> </span><span class="k">not</span><span class="w"> </span><span class="n">enforced</span><span class="p">)</span>
<span class="n">SERVER</span><span class="w"> </span><span class="n">hdfs_server</span>
<span class="k">OPTIONS</span><span class="p">(</span><span class="n">format</span><span class="w"> </span><span class="s1">'orc'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">foldername</span><span class="w"> </span><span class="s1">'/user/hive/warehouse/gauss.db/region_orc11_64stripe'</span><span class="p">)</span>
<span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">roundrobin</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li452941143112">Check whether the region table has an informational constraint index:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen15796173112410"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">relname</span><span class="p">,</span><span class="n">relhasindex</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_class</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">oid</span><span class="o">=</span><span class="s1">'ft_region'</span><span class="p">::</span><span class="n">regclass</span><span class="p">;</span>
<span class="w"> </span><span class="n">relname</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">relhasindex</span><span class="w"> </span>
<span class="c1">------------------------+-------------</span>
<span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">f</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">conname</span><span class="p">,</span><span class="w"> </span><span class="n">contype</span><span class="p">,</span><span class="w"> </span><span class="n">consoft</span><span class="p">,</span><span class="w"> </span><span class="n">conopt</span><span class="p">,</span><span class="w"> </span><span class="n">conindid</span><span class="p">,</span><span class="w"> </span><span class="n">conkey</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_constraint</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">conname</span><span class="w"> </span><span class="o">=</span><span class="s1">'ft_region_pkey'</span><span class="p">;</span>
<span class="w"> </span><span class="n">conname</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">contype</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">consoft</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">conopt</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">conindid</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">conkey</span>
<span class="c1">---------------+---------+---------+--------+----------+--------</span>
<span class="n">ft_region_pkey</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">p</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">t</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="err">{</span><span class="mi">1</span><span class="err">}</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li2201182523111">Delete the informational constraint:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen5653119122510"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="n">ft_region_pkey</span><span class="w"> </span><span class="k">RESTRICT</span><span class="p">;</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">conname</span><span class="p">,</span><span class="w"> </span><span class="n">contype</span><span class="p">,</span><span class="w"> </span><span class="n">consoft</span><span class="p">,</span><span class="w"> </span><span class="n">conindid</span><span class="p">,</span><span class="w"> </span><span class="n">conkey</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_constraint</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">conname</span><span class="w"> </span><span class="o">=</span><span class="s1">'ft_region_pkey'</span><span class="p">;</span>
<span class="w"> </span><span class="n">conname</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">contype</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">consoft</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">conindid</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">conkey</span><span class="w"> </span>
<span class="c1">---------+---------+---------+----------+--------</span>
<span class="p">(</span><span class="mi">0</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li13941130182610">Add a unique informational constraint for the foreign table:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen1481913239272"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="n">constr_unique</span><span class="w"> </span><span class="k">UNIQUE</span><span class="p">(</span><span class="n">R_REGIONKEY</span><span class="p">)</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="n">ENFORCED</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="p" id="EN-US_TOPIC_0000001233628569__p17194323218">Delete the unique informational constraint:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen26522033132715"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="n">constr_unique</span><span class="w"> </span><span class="k">RESTRICT</span><span class="p">;</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">conname</span><span class="p">,</span><span class="w"> </span><span class="n">contype</span><span class="p">,</span><span class="w"> </span><span class="n">consoft</span><span class="p">,</span><span class="w"> </span><span class="n">conindid</span><span class="p">,</span><span class="w"> </span><span class="n">conkey</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_constraint</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">conname</span><span class="w"> </span><span class="o">=</span><span class="s1">'constr_unique'</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li628332014261">Add a unique informational constraint for the foreign table:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen636919132810"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="k">ADD</span><span class="w"> </span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="n">constr_unique</span><span class="w"> </span><span class="k">UNIQUE</span><span class="p">(</span><span class="n">R_REGIONKEY</span><span class="p">)</span><span class="w"> </span><span class="k">NOT</span><span class="w"> </span><span class="n">ENFORCED</span><span class="w"> </span><span class="n">disable</span><span class="w"> </span><span class="n">query</span><span class="w"> </span><span class="n">optimization</span><span class="p">;</span>
<span class="k">SELECT</span><span class="w"> </span><span class="n">relname</span><span class="p">,</span><span class="n">relhasindex</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">pg_class</span><span class="w"> </span><span class="k">WHERE</span><span class="w"> </span><span class="n">oid</span><span class="o">=</span><span class="s1">'ft_region'</span><span class="p">::</span><span class="n">regclass</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
<div class="p" id="EN-US_TOPIC_0000001233628569__p659010553216">Delete the unique informational constraint:<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen957923872819"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">ft_region</span><span class="w"> </span><span class="k">DROP</span><span class="w"> </span><span class="k">CONSTRAINT</span><span class="w"> </span><span class="n">constr_unique</span><span class="w"> </span><span class="k">CASCADE</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</div>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__section161114520013"><h4 class="sectiontitle">Example 4</h4><p id="EN-US_TOPIC_0000001233628569__p20282451007">Read json data stored in OBS using a foreign table.</p>
<ol id="EN-US_TOPIC_0000001233628569__o1df10162001d44a097255e6f5f7b38c2"><li id="EN-US_TOPIC_0000001233628569__li204448071017">The following JSON files are on OBS. The JSON objects contain nesting and arrays. Some objects have lost columns, and some object names are duplicate.<pre class="screen" id="EN-US_TOPIC_0000001233628569__screen105740504107">{"A" : "simple1", "B" : {"C" : "nesting1"}, "D" : ["array", 2, {"E" : "complicated"}]}
{"A" : "simple2", "D" : ["array", 2, {"E" : "complicated"}]}
{"A" : "simple3", "B" : {"C" : "nesting3"}, "D" : ["array", 2, {"E" : "complicated3"}]}
{"B" : {"C" : "nesting4"},"A" : "simple4", "D" : ["array", 2, {"E" : "complicated4"}]}
{"A" : "simple5", "B" : {"C" : "nesting5"}, "D" : ["array", 2, {"E" : "complicated5"}]}</pre>
</li><li id="EN-US_TOPIC_0000001233628569__lfbdcefce811f42bf81cc8be2c97375d1">Create <strong id="EN-US_TOPIC_0000001233628569__b74424369910939">obs_server</strong>, with <strong id="EN-US_TOPIC_0000001233628569__b99476017610939">DFS_FDW</strong> as the foreign data wrapper.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen456545134713"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="n">SERVER</span><span class="w"> </span><span class="n">obs_server</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">DATA</span><span class="w"> </span><span class="n">WRAPPER</span><span class="w"> </span><span class="n">DFS_FDW</span><span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span>
<span class="w"> </span><span class="n">ADDRESS</span><span class="w"> </span><span class="s1">'obs.xxx.xxx.com'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ACCESS_KEY</span><span class="w"> </span><span class="s1">'xxxxxxxxx'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">SECRET_ACCESS_KEY</span><span class="w"> </span><span class="s1">'yyyyyyyyyyyyy'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="k">TYPE</span><span class="w"> </span><span class="s1">'OBS'</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001233628569__note125666519473"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul19566115144715"><li id="EN-US_TOPIC_0000001233628569__li8566051104718"><strong id="EN-US_TOPIC_0000001233628569__b101881746151411">ADDRESS</strong> is the endpoint of OBS. Replace it with the actual endpoint. You can find the domain name by searching for the value of <strong id="EN-US_TOPIC_0000001233628569__b142771828162616">regionCode</strong> in the <strong id="EN-US_TOPIC_0000001233628569__b182791028142613">region_map</strong> file.</li><li id="EN-US_TOPIC_0000001233628569__li10566451184719"><strong id="EN-US_TOPIC_0000001233628569__b842352706112355">ACCESS_KEY</strong> and <strong id="EN-US_TOPIC_0000001233628569__b842352706112359">SECRET_ACCESS_KEY</strong> are access keys for the cloud account system. Replace the values as needed.</li><li id="EN-US_TOPIC_0000001233628569__li2064467111712">Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</li><li id="EN-US_TOPIC_0000001233628569__li556614517476"><strong id="EN-US_TOPIC_0000001233628569__b84235270611539">TYPE</strong> indicates the server type. Retain the value <strong id="EN-US_TOPIC_0000001233628569__b203080400210939">OBS</strong>.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__l7570c540455a4c6a8682492534f078c4">Create the OBS foreign table <strong id="EN-US_TOPIC_0000001233628569__b2737360349">json_f</strong> and define the column names. For example, <strong id="EN-US_TOPIC_0000001233628569__b1716891183518">d#2_e</strong> indicates that the column is object <strong id="EN-US_TOPIC_0000001233628569__b194655811368">e</strong> nested in the <strong id="EN-US_TOPIC_0000001233628569__b65921028133618">2</strong>nd element of array <strong id="EN-US_TOPIC_0000001233628569__b3537105943518">d</strong>. The OBS server associated with the table is <strong id="EN-US_TOPIC_0000001233628569__b29268104218">obs_server</strong>. <strong id="EN-US_TOPIC_0000001233628569__b13131638174213">foldername</strong> indicates the data source directory of the foreign table, that is, the OBS directory.<div class="notice" id="EN-US_TOPIC_0000001233628569__note5919105782315"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233628569__p49191857152316">// Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</p>
</div></div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen7567115112473"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">json_f</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">10</span><span class="p">),</span>
<span class="w"> </span><span class="n">b_c</span><span class="w"> </span><span class="nb">TEXT</span><span class="p">,</span>
<span class="w"> </span><span class="n">d</span><span class="o">#</span><span class="mi">1</span><span class="w"> </span><span class="nb">INTEGER</span><span class="p">,</span>
<span class="w"> </span><span class="n">d</span><span class="o">#</span><span class="mi">2</span><span class="n">_e</span><span class="w"> </span><span class="nb">VARCHAR</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span>
<span class="p">)</span><span class="n">SERVER</span><span class="w"> </span><span class="n">obs_server</span><span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">foldername</span><span class="w"> </span><span class="s1">'/xxx/xxx/'</span><span class="p">,</span>
<span class="w"> </span><span class="n">format</span><span class="w"> </span><span class="s1">'json'</span><span class="p">,</span>
<span class="w"> </span><span class="k">encoding</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">force_mapping</span><span class="w"> </span><span class="s1">'true'</span>
<span class="p">)</span><span class="n">distribute</span><span class="w"> </span><span class="k">by</span><span class="w"> </span><span class="n">roundrobin</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__l7f6a0650ccf4404287dd87978a02b7b6">Query the foreign table <strong id="EN-US_TOPIC_0000001233628569__b8888162711423">json_f</strong>. The fault tolerance parameter force_mapping is enabled by default. If a column is missing in a JSON object, NULL is filled in. If a JSON object name is duplicate, the last name prevails.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__se90c035c1eec418faf622fb798e70f62"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span>
<span class="normal">8</span>
<span class="normal">9</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="o">*</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">json_f</span><span class="p">;</span>
<span class="w"> </span><span class="n">a</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">b_c</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">d</span><span class="o">#</span><span class="mi">1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">d</span><span class="o">#</span><span class="mi">2</span><span class="n">_e</span>
<span class="c1">---------+----------+-----+--------------</span>
<span class="w"> </span><span class="n">simple1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nesting1</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">complicated1</span>
<span class="w"> </span><span class="n">simple2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">complicated2</span>
<span class="w"> </span><span class="n">simple3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nesting3</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">complicated3</span>
<span class="w"> </span><span class="n">simple4</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nesting4</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">complicated4</span>
<span class="w"> </span><span class="n">repeat</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">nesting5</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="mi">2</span><span class="w"> </span><span class="o">|</span><span class="w"> </span><span class="n">complicated5</span>
<span class="p">(</span><span class="mi">5</span><span class="w"> </span><span class="k">rows</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__section1376121210133"><h4 class="sectiontitle">Example 5</h4><p id="EN-US_TOPIC_0000001233628569__p5973173162519">Read a DLI multi-version foreign table using a foreign table. Only DLI 8.1.1 and later support the multi-version foreign table example.</p>
<ol id="EN-US_TOPIC_0000001233628569__ol15187435102517"><li id="EN-US_TOPIC_0000001233628569__li1418712359250">Create <strong id="EN-US_TOPIC_0000001233628569__b44034025514">dli_server</strong>, with <strong id="EN-US_TOPIC_0000001233628569__b747154015516">DFS_FDW</strong> as the foreign data wrapper.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen47651321910"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span>
<span class="normal">6</span>
<span class="normal">7</span>
<span class="normal">8</span>
<span class="normal">9</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="n">SERVER</span><span class="w"> </span><span class="n">dli_server</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">DATA</span><span class="w"> </span><span class="n">WRAPPER</span><span class="w"> </span><span class="n">DFS_FDW</span><span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span><span class="w"> </span>
<span class="w"> </span><span class="n">ADDRESS</span><span class="w"> </span><span class="s1">'obs.xxx.xxx.com'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ACCESS_KEY</span><span class="w"> </span><span class="s1">'xxxxxxxxx'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">SECRET_ACCESS_KEY</span><span class="w"> </span><span class="s1">'yyyyyyyyyyyyy'</span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="k">TYPE</span><span class="w"> </span><span class="s1">'DLI'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_ADDRESS</span><span class="w"> </span><span class="s1">'dli.xxx.xxx.com'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_ACCESS_KEY</span><span class="w"> </span><span class="s1">'xxxxxxxxx'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_SECRET_ACCESS_KEY</span><span class="w"> </span><span class="s1">'yyyyyyyyyyyyy'</span>
<span class="p">);</span>
</pre></div></td></tr></table></div>
</div>
<div class="note" id="EN-US_TOPIC_0000001233628569__note8766183210918"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001233628569__ul176616321898"><li id="EN-US_TOPIC_0000001233628569__li35346467463"><strong id="EN-US_TOPIC_0000001233628569__b0152246121116">ADDRESS</strong> is the endpoint of OBS. <strong id="EN-US_TOPIC_0000001233628569__b1271862251212">DLI_ADDRESS</strong> is the endpoint of DLI. Replace it with the actual endpoint.</li><li id="EN-US_TOPIC_0000001233628569__li16766173215913"><strong id="EN-US_TOPIC_0000001233628569__b55607633">ACCESS_KEY</strong> and <strong id="EN-US_TOPIC_0000001233628569__b1726353142">SECRET_ACCESS_KEY</strong> are access keys for the cloud account system to access OBS. Use the actual value.</li><li id="EN-US_TOPIC_0000001233628569__li132649461317"><strong id="EN-US_TOPIC_0000001233628569__b16394153419421">DLI_ACCESS_KEY</strong> and <strong id="EN-US_TOPIC_0000001233628569__b16400133494210">DLI_SECRET_ACCESS_KEY</strong> are access keys for the cloud account system to access DLI. Use the actual value.</li><li id="EN-US_TOPIC_0000001233628569__li25251129171713">Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</li><li id="EN-US_TOPIC_0000001233628569__li9766832893"><strong id="EN-US_TOPIC_0000001233628569__b721533442">TYPE</strong> indicates the server type. Retain the value <strong id="EN-US_TOPIC_0000001233628569__en-us_topic_0085031719_b84235270611651">DLI</strong>.</li></ul>
</div></div>
</li><li id="EN-US_TOPIC_0000001233628569__li7554163017262">Create the OBS foreign table <strong id="EN-US_TOPIC_0000001233628569__b6282164717550">customer_address</strong> for accessing DLI. The table does not contain partition columns, and the DLI server associated with the table is <strong id="EN-US_TOPIC_0000001233628569__b1028910474556">dli_server</strong>. Where, the <strong id="EN-US_TOPIC_0000001233628569__b812095819569">project_id</strong> is <em id="EN-US_TOPIC_0000001233628569__i13361205235615">xxxxxxxxxxxxxxx</em>, the <strong id="EN-US_TOPIC_0000001233628569__b13395161145719">database_name</strong> on DLI is <strong id="EN-US_TOPIC_0000001233628569__b15142182017579">database123</strong>, and the <strong id="EN-US_TOPIC_0000001233628569__b44251442571">table_name</strong> of the table to be accessed is <strong id="EN-US_TOPIC_0000001233628569__b15717100135811">table456</strong>. Replace them based on the actual requirements.<div class="notice" id="EN-US_TOPIC_0000001233628569__note1299481971819"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001233628569__p982411264181">// Hard-coded or plaintext AK and SK are risky. For security purposes, encrypt your AK and SK and store them in the configuration file or environment variables.</p>
</div></div>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen1876723211915"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal"> 1</span>
<span class="normal"> 2</span>
<span class="normal"> 3</span>
<span class="normal"> 4</span>
<span class="normal"> 5</span>
<span class="normal"> 6</span>
<span class="normal"> 7</span>
<span class="normal"> 8</span>
<span class="normal"> 9</span>
<span class="normal">10</span>
<span class="normal">11</span>
<span class="normal">12</span>
<span class="normal">13</span>
<span class="normal">14</span>
<span class="normal">15</span>
<span class="normal">16</span>
<span class="normal">17</span>
<span class="normal">18</span>
<span class="normal">19</span>
<span class="normal">20</span>
<span class="normal">21</span>
<span class="normal">22</span>
<span class="normal">23</span>
<span class="normal">24</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">CREATE</span><span class="w"> </span><span class="k">FOREIGN</span><span class="w"> </span><span class="k">TABLE</span><span class="w"> </span><span class="n">customer_address</span>
<span class="p">(</span>
<span class="w"> </span><span class="n">ca_address_sk</span><span class="w"> </span><span class="nb">integer</span><span class="w"> </span><span class="k">not</span><span class="w"> </span><span class="k">null</span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_address_id</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">16</span><span class="p">)</span><span class="w"> </span><span class="k">not</span><span class="w"> </span><span class="k">null</span><span class="p">,</span>
<span class="w"> </span><span class="n">ca_street_number</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_street_name</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">60</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_street_type</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">15</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_suite_number</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_city</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">60</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_county</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_state</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_zip</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">10</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_country</span><span class="w"> </span><span class="nb">varchar</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_gmt_offset</span><span class="w"> </span><span class="nb">decimal</span><span class="p">(</span><span class="mi">36</span><span class="p">,</span><span class="mi">33</span><span class="p">)</span><span class="w"> </span><span class="p">,</span><span class="w"> </span>
<span class="w"> </span><span class="n">ca_location_type</span><span class="w"> </span><span class="nb">char</span><span class="p">(</span><span class="mi">20</span><span class="p">)</span><span class="w"> </span>
<span class="p">)</span><span class="w"> </span>
<span class="n">SERVER</span><span class="w"> </span><span class="n">dli_server</span><span class="w"> </span><span class="k">OPTIONS</span><span class="w"> </span><span class="p">(</span>
<span class="w"> </span><span class="n">FORMAT</span><span class="w"> </span><span class="s1">'ORC'</span><span class="p">,</span>
<span class="w"> </span><span class="k">ENCODING</span><span class="w"> </span><span class="s1">'utf8'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_PROJECT_ID</span><span class="w"> </span><span class="s1">'xxxxxxxxxxxxxxx'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_DATABASE_NAME</span><span class="w"> </span><span class="s1">'database123'</span><span class="p">,</span>
<span class="w"> </span><span class="n">DLI_TABLE_NAME</span><span class="w"> </span><span class="s1">'table456'</span>
<span class="p">)</span>
<span class="n">DISTRIBUTE</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">roundrobin</span><span class="p">;</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001233628569__li140722216286">Query data in a DLI multi-version table using a foreign table.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001233628569__screen1076815328910"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">COUNT</span><span class="p">(</span><span class="o">*</span><span class="p">)</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">customer_address</span><span class="p">;</span>
<span class="w"> </span><span class="k">count</span><span class="w"> </span>
<span class="c1">-------</span>
<span class="w"> </span><span class="mi">20</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000001233628569__s0fbc2a5223194abfab6ef421286065cc"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001233628569__a7b4398c8c0884924933ea2c990002227"><a href="dws_06_0124.html">ALTER FOREIGN TABLE (for HDFS or OBS)</a>, <a href="dws_06_0192.html">DROP FOREIGN TABLE</a></p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0118.html">DDL Syntax</a></div>
</div>
</div>
View Git Blame Copy Permalink