blob: 5b32823c904c364e2b3322aacf77aba78495edc0 [file] [log] [blame]
<!DOCTYPE html>
<html class="writer-html5" lang="en" >
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>pyarrow.csv.ConvertOptions &mdash; Apache Arrow v2.0.0</title>
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
<script type="text/javascript" id="documentation_options" data-url_root="../../" src="../../_static/documentation_options.js"></script>
<script src="../../_static/jquery.js"></script>
<script src="../../_static/underscore.js"></script>
<script src="../../_static/doctools.js"></script>
<script src="../../_static/language_data.js"></script>
<script type="text/javascript" src="../../_static/js/theme.js"></script>
<link rel="canonical" href="https://arrow.apache.org/docs/python/generated/pyarrow.csv.ConvertOptions.html" />
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="pyarrow.csv.read_csv" href="pyarrow.csv.read_csv.html" />
<link rel="prev" title="pyarrow.csv.ParseOptions" href="pyarrow.csv.ParseOptions.html" />
<!-- Matomo -->
<script>
var _paq = window._paq = window._paq || [];
/* tracker methods like "setCustomDimension" should be called before "trackPageView" */
_paq.push(["setDoNotTrack", true]);
_paq.push(["disableCookies"]);
_paq.push(['trackPageView']);
_paq.push(['enableLinkTracking']);
(function() {
var u="https://analytics.apache.org/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', '20']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.async=true; g.src=u+'matomo.js'; s.parentNode.insertBefore(g,s);
})();
</script>
<!-- End Matomo Code -->
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="../../index.html" class="icon icon-home" alt="Documentation Home"> Apache Arrow
</a>
<div class="version">
2.0.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Specifications and Protocols</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../format/Versioning.html">Format Versioning and Stability</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/Columnar.html">Arrow Columnar Format</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/Flight.html">Arrow Flight RPC</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/Integration.html">Integration Testing</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/CDataInterface.html">The Arrow C data interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/CStreamInterface.html">The Arrow C stream interface</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../format/Other.html">Other Data Structures</a></li>
</ul>
<p class="caption"><span class="caption-text">Libraries</span></p>
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../../status.html">Implementation Status</a></li>
<li class="toctree-l1"><a class="reference external" href="https://arrow.apache.org/docs/c_glib/">C/GLib</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../cpp/index.html">C++</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/apache/arrow/blob/master/csharp/README.md">C#</a></li>
<li class="toctree-l1"><a class="reference external" href="https://godoc.org/github.com/apache/arrow/go/arrow">Go</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../java/index.html">Java</a></li>
<li class="toctree-l1"><a class="reference external" href="https://arrow.apache.org/docs/js/">JavaScript</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/apache/arrow/blob/master/matlab/README.md">MATLAB</a></li>
<li class="toctree-l1 current"><a class="reference internal" href="../index.html">Python</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="../install.html">Installing PyArrow</a></li>
<li class="toctree-l2"><a class="reference internal" href="../memory.html">Memory and IO Interfaces</a></li>
<li class="toctree-l2"><a class="reference internal" href="../data.html">Data Types and In-Memory Data Model</a></li>
<li class="toctree-l2"><a class="reference internal" href="../compute.html">Compute Functions</a></li>
<li class="toctree-l2"><a class="reference internal" href="../ipc.html">Streaming, Serialization, and IPC</a></li>
<li class="toctree-l2"><a class="reference internal" href="../filesystems.html">Filesystem Interface</a></li>
<li class="toctree-l2"><a class="reference internal" href="../filesystems_deprecated.html">Filesystem Interface (legacy)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../plasma.html">The Plasma In-Memory Object Store</a></li>
<li class="toctree-l2"><a class="reference internal" href="../numpy.html">NumPy Integration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../pandas.html">Pandas Integration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../timestamps.html">Timestamps</a></li>
<li class="toctree-l2"><a class="reference internal" href="../csv.html">Reading CSV files</a></li>
<li class="toctree-l2"><a class="reference internal" href="../feather.html">Feather File Format</a></li>
<li class="toctree-l2"><a class="reference internal" href="../json.html">Reading JSON files</a></li>
<li class="toctree-l2"><a class="reference internal" href="../parquet.html">Reading and Writing the Apache Parquet Format</a></li>
<li class="toctree-l2"><a class="reference internal" href="../dataset.html">Tabular Datasets</a></li>
<li class="toctree-l2"><a class="reference internal" href="../cuda.html">CUDA Integration</a></li>
<li class="toctree-l2"><a class="reference internal" href="../extending_types.html">Extending pyarrow</a></li>
<li class="toctree-l2"><a class="reference internal" href="../extending.html">Using pyarrow from C++ and Cython Code</a></li>
<li class="toctree-l2 current"><a class="reference internal" href="../api.html">API Reference</a><ul class="current">
<li class="toctree-l3"><a class="reference internal" href="../api/datatypes.html">Data Types and Schemas</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/arrays.html">Arrays and Scalars</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/memory.html">Buffers and Memory</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/compute.html">Compute Functions</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/files.html">Streams and File Access</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/tables.html">Tables and Tensors</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/ipc.html">Serialization and IPC</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/flight.html">Arrow Flight</a></li>
<li class="toctree-l3 current"><a class="reference internal" href="../api/formats.html">Tabular File Formats</a><ul class="current">
<li class="toctree-l4 current"><a class="reference internal" href="../api/formats.html#csv-files">CSV Files</a></li>
<li class="toctree-l4"><a class="reference internal" href="../api/formats.html#feather-files">Feather Files</a></li>
<li class="toctree-l4"><a class="reference internal" href="../api/formats.html#json-files">JSON Files</a></li>
<li class="toctree-l4"><a class="reference internal" href="../api/formats.html#parquet-files">Parquet Files</a></li>
<li class="toctree-l4"><a class="reference internal" href="../api/formats.html#orc-files">ORC Files</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../api/filesystems.html">Filesystems</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/dataset.html">Dataset</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/plasma.html">Plasma In-Memory Object Store</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/cuda.html">CUDA Integration</a></li>
<li class="toctree-l3"><a class="reference internal" href="../api/misc.html">Miscellaneous</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../getting_involved.html">Getting Involved</a></li>
<li class="toctree-l2"><a class="reference internal" href="../benchmarks.html">Benchmarks</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference external" href="https://arrow.apache.org/docs/r/">R</a></li>
<li class="toctree-l1"><a class="reference external" href="https://github.com/apache/arrow/blob/master/ruby/README.md">Ruby</a></li>
<li class="toctree-l1"><a class="reference external" href="https://docs.rs/crate/arrow/">Rust</a></li>
</ul>
<p class="caption"><span class="caption-text">Development</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../../developers/contributing.html">Contributing to Apache Arrow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/cpp/index.html">C++ Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/python.html">Python Development</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/archery.html">Daily Development using Archery</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/crossbow.html">Packaging and Testing with Crossbow</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/docker.html">Running Docker Builds</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/benchmarks.html">Benchmarks</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../developers/documentation.html">Building the Documentation</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="../../index.html">Apache Arrow</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="../../index.html" class="icon icon-home"></a> &raquo;</li>
<li><a href="../index.html">Python bindings</a> &raquo;</li>
<li><a href="../api.html">API Reference</a> &raquo;</li>
<li><a href="../api/formats.html">Tabular File Formats</a> &raquo;</li>
<li>pyarrow.csv.ConvertOptions</li>
<li class="wy-breadcrumbs-aside">
<a href="../../_sources/python/generated/pyarrow.csv.ConvertOptions.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<div class="section" id="pyarrow-csv-convertoptions">
<h1>pyarrow.csv.ConvertOptions<a class="headerlink" href="#pyarrow-csv-convertoptions" title="Permalink to this headline"></a></h1>
<dl class="py class">
<dt id="pyarrow.csv.ConvertOptions">
<em class="property">class </em><code class="sig-prename descclassname">pyarrow.csv.</code><code class="sig-name descname">ConvertOptions</code><span class="sig-paren">(</span><em class="sig-param"><span class="n">check_utf8</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="o">*</span></em>, <em class="sig-param"><span class="n">column_types</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">null_values</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">true_values</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">false_values</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">strings_can_be_null</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">include_columns</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">include_missing_columns</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">auto_dict_encode</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">auto_dict_max_cardinality</span><span class="o">=</span><span class="default_value">None</span></em>, <em class="sig-param"><span class="n">timestamp_parsers</span><span class="o">=</span><span class="default_value">None</span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyarrow.csv.ConvertOptions" title="Permalink to this definition"></a></dt>
<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">pyarrow.lib._Weakrefable</span></code></p>
<p>Options for converting CSV data.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters</dt>
<dd class="field-odd"><ul class="simple">
<li><p><strong>check_utf8</strong> (<em>bool</em><em>, </em><em>optional</em><em> (</em><em>default True</em><em>)</em>) – Whether to check UTF8 validity of string columns.</p></li>
<li><p><strong>column_types</strong> (<em>pa.Schema</em><em> or </em><em>dict</em><em>, </em><em>optional</em>) – Explicitly map column names to column types. Passing this argument
disables type inference on the defined columns.</p></li>
<li><p><strong>null_values</strong> (<em>list</em><em>, </em><em>optional</em>) – A sequence of strings that denote nulls in the data
(defaults are appropriate in most cases). Note that by default,
string columns are not checked for null values. To enable
null checking for those, specify <code class="docutils literal notranslate"><span class="pre">strings_can_be_null=True</span></code>.</p></li>
<li><p><strong>true_values</strong> (<em>list</em><em>, </em><em>optional</em>) – A sequence of strings that denote true booleans in the data
(defaults are appropriate in most cases).</p></li>
<li><p><strong>false_values</strong> (<em>list</em><em>, </em><em>optional</em>) – A sequence of strings that denote false booleans in the data
(defaults are appropriate in most cases).</p></li>
<li><p><strong>timestamp_parsers</strong> (<em>list</em><em>, </em><em>optional</em>) – A sequence of strptime()-compatible format strings, tried in order
when attempting to infer or convert timestamp values (the special
value ISO8601() can also be given). By default, a fast built-in
ISO-8601 parser is used.</p></li>
<li><p><strong>strings_can_be_null</strong> (<em>bool</em><em>, </em><em>optional</em><em> (</em><em>default False</em><em>)</em>) – Whether string / binary columns can have null values.
If true, then strings in null_values are considered null for
string columns.
If false, then all strings are valid string values.</p></li>
<li><p><strong>auto_dict_encode</strong> (<em>bool</em><em>, </em><em>optional</em><em> (</em><em>default False</em><em>)</em>) – Whether to try to automatically dict-encode string / binary data.
If true, then when type inference detects a string or binary column,
it it dict-encoded up to <cite>auto_dict_max_cardinality</cite> distinct values
(per chunk), after which it switches to regular encoding.
This setting is ignored for non-inferred columns (those in
<cite>column_types</cite>).</p></li>
<li><p><strong>auto_dict_max_cardinality</strong> (<em>int</em><em>, </em><em>optional</em>) – The maximum dictionary cardinality for <cite>auto_dict_encode</cite>.
This value is per chunk.</p></li>
<li><p><strong>include_columns</strong> (<em>list</em><em>, </em><em>optional</em>) – The names of columns to include in the Table.
If empty, the Table will include all columns from the CSV file.
If not empty, only these columns will be included, in this order.</p></li>
<li><p><strong>include_missing_columns</strong> (<em>bool</em><em>, </em><em>optional</em><em> (</em><em>default False</em><em>)</em>) – If false, columns in <cite>include_columns</cite> but not in the CSV file will
error out.
If true, columns in <cite>include_columns</cite> but not in the CSV file will
produce a column of nulls (whose type is selected using
<cite>column_types</cite>, or null by default).
This option is ignored if <cite>include_columns</cite> is empty.</p></li>
</ul>
</dd>
</dl>
<dl class="py method">
<dt id="pyarrow.csv.ConvertOptions.__init__">
<code class="sig-name descname">__init__</code><span class="sig-paren">(</span><em class="sig-param"><span class="o">*</span><span class="n">args</span></em>, <em class="sig-param"><span class="o">**</span><span class="n">kwargs</span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyarrow.csv.ConvertOptions.__init__" title="Permalink to this definition"></a></dt>
<dd><p>Initialize self. See help(type(self)) for accurate signature.</p>
</dd></dl>
<p class="rubric">Methods</p>
<table class="longtable docutils align-default">
<colgroup>
<col style="width: 10%" />
<col style="width: 90%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.__init__" title="pyarrow.csv.ConvertOptions.__init__"><code class="xref py py-obj docutils literal notranslate"><span class="pre">__init__</span></code></a>(*args, **kwargs)</p></td>
<td><p>Initialize self.</p></td>
</tr>
</tbody>
</table>
<p class="rubric">Attributes</p>
<table class="longtable docutils align-default">
<colgroup>
<col style="width: 10%" />
<col style="width: 90%" />
</colgroup>
<tbody>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.auto_dict_encode" title="pyarrow.csv.ConvertOptions.auto_dict_encode"><code class="xref py py-obj docutils literal notranslate"><span class="pre">auto_dict_encode</span></code></a></p></td>
<td><p>Whether to try to automatically dict-encode string / binary data.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.auto_dict_max_cardinality" title="pyarrow.csv.ConvertOptions.auto_dict_max_cardinality"><code class="xref py py-obj docutils literal notranslate"><span class="pre">auto_dict_max_cardinality</span></code></a></p></td>
<td><p>The maximum dictionary cardinality for <cite>auto_dict_encode</cite>.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.check_utf8" title="pyarrow.csv.ConvertOptions.check_utf8"><code class="xref py py-obj docutils literal notranslate"><span class="pre">check_utf8</span></code></a></p></td>
<td><p>Whether to check UTF8 validity of string columns.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.column_types" title="pyarrow.csv.ConvertOptions.column_types"><code class="xref py py-obj docutils literal notranslate"><span class="pre">column_types</span></code></a></p></td>
<td><p>Explicitly map column names to column types.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.false_values" title="pyarrow.csv.ConvertOptions.false_values"><code class="xref py py-obj docutils literal notranslate"><span class="pre">false_values</span></code></a></p></td>
<td><p>A sequence of strings that denote false booleans in the data.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.include_columns" title="pyarrow.csv.ConvertOptions.include_columns"><code class="xref py py-obj docutils literal notranslate"><span class="pre">include_columns</span></code></a></p></td>
<td><p>The names of columns to include in the Table.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.include_missing_columns" title="pyarrow.csv.ConvertOptions.include_missing_columns"><code class="xref py py-obj docutils literal notranslate"><span class="pre">include_missing_columns</span></code></a></p></td>
<td><p>If false, columns in <cite>include_columns</cite> but not in the CSV file will error out.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.null_values" title="pyarrow.csv.ConvertOptions.null_values"><code class="xref py py-obj docutils literal notranslate"><span class="pre">null_values</span></code></a></p></td>
<td><p>A sequence of strings that denote nulls in the data.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.strings_can_be_null" title="pyarrow.csv.ConvertOptions.strings_can_be_null"><code class="xref py py-obj docutils literal notranslate"><span class="pre">strings_can_be_null</span></code></a></p></td>
<td><p>Whether string / binary columns can have null values.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.timestamp_parsers" title="pyarrow.csv.ConvertOptions.timestamp_parsers"><code class="xref py py-obj docutils literal notranslate"><span class="pre">timestamp_parsers</span></code></a></p></td>
<td><p>A sequence of strptime()-compatible format strings, tried in order when attempting to infer or convert timestamp values (the special value ISO8601() can also be given).</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#pyarrow.csv.ConvertOptions.true_values" title="pyarrow.csv.ConvertOptions.true_values"><code class="xref py py-obj docutils literal notranslate"><span class="pre">true_values</span></code></a></p></td>
<td><p>A sequence of strings that denote true booleans in the data.</p></td>
</tr>
</tbody>
</table>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.auto_dict_encode">
<code class="sig-name descname">auto_dict_encode</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.auto_dict_encode" title="Permalink to this definition"></a></dt>
<dd><p>Whether to try to automatically dict-encode string / binary data.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.auto_dict_max_cardinality">
<code class="sig-name descname">auto_dict_max_cardinality</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.auto_dict_max_cardinality" title="Permalink to this definition"></a></dt>
<dd><p>The maximum dictionary cardinality for <cite>auto_dict_encode</cite>.</p>
<p>This value is per chunk.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.check_utf8">
<code class="sig-name descname">check_utf8</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.check_utf8" title="Permalink to this definition"></a></dt>
<dd><p>Whether to check UTF8 validity of string columns.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.column_types">
<code class="sig-name descname">column_types</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.column_types" title="Permalink to this definition"></a></dt>
<dd><p>Explicitly map column names to column types.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.false_values">
<code class="sig-name descname">false_values</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.false_values" title="Permalink to this definition"></a></dt>
<dd><p>A sequence of strings that denote false booleans in the data.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.include_columns">
<code class="sig-name descname">include_columns</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.include_columns" title="Permalink to this definition"></a></dt>
<dd><p>The names of columns to include in the Table.</p>
<p>If empty, the Table will include all columns from the CSV file.
If not empty, only these columns will be included, in this order.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.include_missing_columns">
<code class="sig-name descname">include_missing_columns</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.include_missing_columns" title="Permalink to this definition"></a></dt>
<dd><p>If false, columns in <cite>include_columns</cite> but not in the CSV file will
error out.
If true, columns in <cite>include_columns</cite> but not in the CSV file will
produce a null column (whose type is selected using <cite>column_types</cite>,
or null by default).
This option is ignored if <cite>include_columns</cite> is empty.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.null_values">
<code class="sig-name descname">null_values</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.null_values" title="Permalink to this definition"></a></dt>
<dd><p>A sequence of strings that denote nulls in the data.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.strings_can_be_null">
<code class="sig-name descname">strings_can_be_null</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.strings_can_be_null" title="Permalink to this definition"></a></dt>
<dd><p>Whether string / binary columns can have null values.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.timestamp_parsers">
<code class="sig-name descname">timestamp_parsers</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.timestamp_parsers" title="Permalink to this definition"></a></dt>
<dd><p>A sequence of strptime()-compatible format strings, tried in order
when attempting to infer or convert timestamp values (the special
value ISO8601() can also be given). By default, a fast built-in
ISO-8601 parser is used.</p>
</dd></dl>
<dl class="py attribute">
<dt id="pyarrow.csv.ConvertOptions.true_values">
<code class="sig-name descname">true_values</code><a class="headerlink" href="#pyarrow.csv.ConvertOptions.true_values" title="Permalink to this definition"></a></dt>
<dd><p>A sequence of strings that denote true booleans in the data.</p>
</dd></dl>
</dd></dl>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="pyarrow.csv.read_csv.html" class="btn btn-neutral float-right" title="pyarrow.csv.read_csv" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="pyarrow.csv.ParseOptions.html" class="btn btn-neutral float-left" title="pyarrow.csv.ParseOptions" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
&copy; Copyright 2016-2019 Apache Software Foundation
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
<script type="text/javascript" src="/docs/_static/versionwarning.js"></script></body>
</html>