|  |  | 
|  | <!DOCTYPE html> | 
|  |  | 
|  | <html> | 
|  | <head> | 
|  | <meta charset="utf-8" /> | 
|  | <meta name="viewport" content="width=device-width, initial-scale=1.0" /> | 
|  | <title>API Reference — Apache Arrow v4.0.1</title> | 
|  |  | 
|  | <link href="../_static/css/theme.css" rel="stylesheet" /> | 
|  | <link href="../_static/css/index.c5995385ac14fb8791e8eb36b4908be2.css" rel="stylesheet" /> | 
|  |  | 
|  |  | 
|  | <link rel="stylesheet" | 
|  | href="../_static/vendor/fontawesome/5.13.0/css/all.min.css"> | 
|  | <link rel="preload" as="font" type="font/woff2" crossorigin | 
|  | href="../_static/vendor/fontawesome/5.13.0/webfonts/fa-solid-900.woff2"> | 
|  | <link rel="preload" as="font" type="font/woff2" crossorigin | 
|  | href="../_static/vendor/fontawesome/5.13.0/webfonts/fa-brands-400.woff2"> | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  | <link rel="stylesheet" type="text/css" href="../_static/pygments.css" /> | 
|  | <link rel="stylesheet" type="text/css" href="../_static/basic.css" /> | 
|  | <link rel="stylesheet" type="text/css" href="../_static/theme_overrides.css" /> | 
|  |  | 
|  | <link rel="preload" as="script" href="../_static/js/index.1c5a1a01449ed65a7b51.js"> | 
|  |  | 
|  | <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js"></script> | 
|  | <script src="../_static/jquery.js"></script> | 
|  | <script src="../_static/underscore.js"></script> | 
|  | <script src="../_static/doctools.js"></script> | 
|  | <link rel="canonical" href="https://arrow.apache.org/docs/python/api.html" /> | 
|  | <link rel="shortcut icon" href="../_static/favicon.ico"/> | 
|  | <link rel="canonical" href="https://arrow.apache.org/docs/python/api.html" /> | 
|  | <link rel="index" title="Index" href="../genindex.html" /> | 
|  | <link rel="search" title="Search" href="../search.html" /> | 
|  | <link rel="next" title="Data Types and Schemas" href="api/datatypes.html" /> | 
|  | <link rel="prev" title="Using pyarrow from C++ and Cython Code" href="extending.html" /> | 
|  | <meta name="viewport" content="width=device-width, initial-scale=1" /> | 
|  | <meta name="docsearch:language" content="en" /> | 
|  |  | 
|  | </head> | 
|  | <body data-spy="scroll" data-target="#bd-toc-nav" data-offset="80"> | 
|  |  | 
|  | <div class="container-fluid" id="banner"></div> | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  | <div class="container-xl"> | 
|  | <div class="row"> | 
|  |  | 
|  |  | 
|  | <!-- Only show if we have sidebars configured, else just a small margin  --> | 
|  | <div class="col-12 col-md-3 bd-sidebar"> | 
|  | <a class="navbar-brand" href="../index.html"> | 
|  | <img src="../_static/arrow.png" class="logo" alt="logo"> | 
|  | </a> | 
|  |  | 
|  | <form class="bd-search d-flex align-items-center" action="../search.html" method="get"> | 
|  | <i class="icon fas fa-search"></i> | 
|  | <input type="search" class="form-control" name="q" id="search-input" placeholder="Search the docs ..." aria-label="Search the docs ..." autocomplete="off" > | 
|  | </form> | 
|  |  | 
|  | <nav class="bd-links" id="bd-docs-nav" aria-label="Main navigation"> | 
|  | <div class="bd-toc-item active"> | 
|  |  | 
|  | <p class="caption"> | 
|  | <span class="caption-text"> | 
|  | Specifications and Protocols | 
|  | </span> | 
|  | </p> | 
|  | <ul class="nav bd-sidenav"> | 
|  | <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 nav bd-sidenav"> | 
|  | <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 has-children"> | 
|  | <a class="reference internal" href="../cpp/index.html"> | 
|  | C++ | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-1" name="toctree-checkbox-1" type="checkbox"/> | 
|  | <label for="toctree-checkbox-1"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l2 has-children"> | 
|  | <a class="reference internal" href="../cpp/getting_started.html"> | 
|  | User Guide | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-2" name="toctree-checkbox-2" type="checkbox"/> | 
|  | <label for="toctree-checkbox-2"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/overview.html"> | 
|  | High-Level Overview | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/conventions.html"> | 
|  | Conventions | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/cmake.html"> | 
|  | Using Arrow C++ in your own project | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/memory.html"> | 
|  | Memory Management | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/arrays.html"> | 
|  | Arrays | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/datatypes.html"> | 
|  | Data Types | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/tables.html"> | 
|  | Tabular Data | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/compute.html"> | 
|  | Compute Functions | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/io.html"> | 
|  | Input / output and filesystems | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/ipc.html"> | 
|  | Reading and writing the Arrow IPC format | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/parquet.html"> | 
|  | Reading and writing Parquet files | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/csv.html"> | 
|  | Reading CSV files | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/json.html"> | 
|  | Reading JSON files | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/dataset.html"> | 
|  | Tabular Datasets | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/flight.html"> | 
|  | Arrow Flight RPC | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l2 has-children"> | 
|  | <a class="reference internal" href="../cpp/examples/index.html"> | 
|  | Examples | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-3" name="toctree-checkbox-3" type="checkbox"/> | 
|  | <label for="toctree-checkbox-3"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/examples/cmake_minimal_build.html"> | 
|  | Minimal build using CMake | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/examples/dataset_documentation_example.html"> | 
|  | Arrow Datasets example | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/examples/row_columnar_conversion.html"> | 
|  | Row to columnar conversion | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/examples/tuple_range_conversion.html"> | 
|  | std::tuple-like ranges to Arrow | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l2 has-children"> | 
|  | <a class="reference internal" href="../cpp/api.html"> | 
|  | API Reference | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-4" name="toctree-checkbox-4" type="checkbox"/> | 
|  | <label for="toctree-checkbox-4"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/support.html"> | 
|  | Programming Support | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/memory.html"> | 
|  | Memory (management) | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/datatype.html"> | 
|  | Data Types | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/array.html"> | 
|  | Arrays | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/scalar.html"> | 
|  | Scalars | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/builder.html"> | 
|  | Array Builders | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/table.html"> | 
|  | Two-dimensional Datasets | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/c_abi.html"> | 
|  | C Interfaces | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/compute.html"> | 
|  | Compute Functions | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/tensor.html"> | 
|  | Tensors | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/utilities.html"> | 
|  | Utilities | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/io.html"> | 
|  | Input / output | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/ipc.html"> | 
|  | Arrow IPC | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/formats.html"> | 
|  | File Formats | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/cuda.html"> | 
|  | CUDA support | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/flight.html"> | 
|  | Arrow Flight RPC | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/filesystem.html"> | 
|  | Filesystems | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="../cpp/api/dataset.html"> | 
|  | Dataset | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </li> | 
|  | </ul> | 
|  | </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 has-children"> | 
|  | <a class="reference internal" href="../java/index.html"> | 
|  | Java | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-5" name="toctree-checkbox-5" type="checkbox"/> | 
|  | <label for="toctree-checkbox-5"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../java/vector.html"> | 
|  | ValueVector | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../java/vector_schema_root.html"> | 
|  | VectorSchemaRoot | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../java/ipc.html"> | 
|  | Reading/Writing IPC formats | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference external" href="https://arrow.apache.org/docs/java/reference/"> | 
|  | Reference (javadoc) | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </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/julia/Arrow/README.md"> | 
|  | Julia | 
|  | </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 active has-children"> | 
|  | <a class="reference internal" href="index.html"> | 
|  | Python | 
|  | </a> | 
|  | <input checked="" class="toctree-checkbox" id="toctree-checkbox-6" name="toctree-checkbox-6" type="checkbox"/> | 
|  | <label for="toctree-checkbox-6"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <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 has-children"> | 
|  | <a class="reference internal" href="filesystems_deprecated.html"> | 
|  | Filesystem Interface (legacy) | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-7" name="toctree-checkbox-7" type="checkbox"/> | 
|  | <label for="toctree-checkbox-7"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.hdfs.connect.html"> | 
|  | pyarrow.hdfs.connect | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.cat.html"> | 
|  | pyarrow.HadoopFileSystem.cat | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.chmod.html"> | 
|  | pyarrow.HadoopFileSystem.chmod | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.chown.html"> | 
|  | pyarrow.HadoopFileSystem.chown | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.delete.html"> | 
|  | pyarrow.HadoopFileSystem.delete | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.df.html"> | 
|  | pyarrow.HadoopFileSystem.df | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.disk_usage.html"> | 
|  | pyarrow.HadoopFileSystem.disk_usage | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.download.html"> | 
|  | pyarrow.HadoopFileSystem.download | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.exists.html"> | 
|  | pyarrow.HadoopFileSystem.exists | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.get_capacity.html"> | 
|  | pyarrow.HadoopFileSystem.get_capacity | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.get_space_used.html"> | 
|  | pyarrow.HadoopFileSystem.get_space_used | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.info.html"> | 
|  | pyarrow.HadoopFileSystem.info | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.ls.html"> | 
|  | pyarrow.HadoopFileSystem.ls | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.mkdir.html"> | 
|  | pyarrow.HadoopFileSystem.mkdir | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.open.html"> | 
|  | pyarrow.HadoopFileSystem.open | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.rename.html"> | 
|  | pyarrow.HadoopFileSystem.rename | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.rm.html"> | 
|  | pyarrow.HadoopFileSystem.rm | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HadoopFileSystem.upload.html"> | 
|  | pyarrow.HadoopFileSystem.upload | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l3"> | 
|  | <a class="reference internal" href="generated/pyarrow.HdfsFile.html"> | 
|  | pyarrow.HdfsFile | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </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 active has-children"> | 
|  | <a class="current reference internal" href="#"> | 
|  | API Reference | 
|  | </a> | 
|  | <input checked="" class="toctree-checkbox" id="toctree-checkbox-8" name="toctree-checkbox-8" type="checkbox"/> | 
|  | <label for="toctree-checkbox-8"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <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"> | 
|  | <a class="reference internal" href="api/formats.html"> | 
|  | Tabular File Formats | 
|  | </a> | 
|  | </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 class="nav bd-sidenav"> | 
|  | <li class="toctree-l1"> | 
|  | <a class="reference internal" href="../developers/contributing.html"> | 
|  | Contributing to Apache Arrow | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l1 has-children"> | 
|  | <a class="reference internal" href="../developers/cpp/index.html"> | 
|  | C++ Development | 
|  | </a> | 
|  | <input class="toctree-checkbox" id="toctree-checkbox-9" name="toctree-checkbox-9" type="checkbox"/> | 
|  | <label for="toctree-checkbox-9"> | 
|  | <i class="fas fa-chevron-down"> | 
|  | </i> | 
|  | </label> | 
|  | <ul> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../developers/cpp/building.html"> | 
|  | Building Arrow C++ | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../developers/cpp/development.html"> | 
|  | Development Guidelines | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../developers/cpp/windows.html"> | 
|  | Developing on Windows | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../developers/cpp/conventions.html"> | 
|  | Conventions | 
|  | </a> | 
|  | </li> | 
|  | <li class="toctree-l2"> | 
|  | <a class="reference internal" href="../developers/cpp/fuzzing.html"> | 
|  | Fuzzing Arrow C++ | 
|  | </a> | 
|  | </li> | 
|  | </ul> | 
|  | </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> | 
|  | </nav> | 
|  | </div> | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  | <div class="d-none d-xl-block col-xl-2 bd-toc"> | 
|  |  | 
|  |  | 
|  | <div class="toc-item"> | 
|  |  | 
|  |  | 
|  | <nav id="bd-toc-nav"> | 
|  |  | 
|  | </nav> | 
|  | </div> | 
|  |  | 
|  | <div class="toc-item"> | 
|  |  | 
|  | </div> | 
|  |  | 
|  |  | 
|  | </div> | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  |  | 
|  | <main class="col-12 col-md-9 col-xl-7 py-md-5 pl-md-5 pr-md-4 bd-content" role="main"> | 
|  |  | 
|  | <div> | 
|  |  | 
|  | <div class="section" id="api-reference"> | 
|  | <span id="api"></span><h1>API Reference<a class="headerlink" href="#api-reference" title="Permalink to this headline">¶</a></h1> | 
|  | <div class="toctree-wrapper compound"> | 
|  | <ul> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/datatypes.html">Data Types and Schemas</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/datatypes.html#factory-functions">Factory Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/datatypes.html#type-classes">Type Classes</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/datatypes.html#type-checking">Type Checking</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/arrays.html">Arrays and Scalars</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/arrays.html#factory-functions">Factory Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/arrays.html#array-types">Array Types</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/arrays.html#scalars">Scalars</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/memory.html">Buffers and Memory</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/memory.html#in-memory-buffers">In-Memory Buffers</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/memory.html#memory-pools">Memory Pools</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/compute.html">Compute Functions</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#aggregations">Aggregations</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#arithmetic-functions">Arithmetic Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#comparisons">Comparisons</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#logical-functions">Logical Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#string-predicates">String Predicates</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#string-transforms">String Transforms</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#containment-tests">Containment tests</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#conversions">Conversions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#selections">Selections</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#associative-transforms">Associative transforms</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#sorts-and-partitions">Sorts and partitions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/compute.html#structural-transforms">Structural Transforms</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/files.html">Streams and File Access</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/files.html#factory-functions">Factory Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/files.html#stream-classes">Stream Classes</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/files.html#file-systems">File Systems</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/tables.html">Tables and Tensors</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/tables.html#factory-functions">Factory Functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/tables.html#classes">Classes</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/tables.html#tensors">Tensors</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/ipc.html">Serialization and IPC</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/ipc.html#inter-process-communication">Inter-Process Communication</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/ipc.html#serialization">Serialization</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/flight.html">Arrow Flight</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/flight.html#common-types">Common Types</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/flight.html#flight-client">Flight Client</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/flight.html#flight-server">Flight Server</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/flight.html#authentication">Authentication</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/flight.html#middleware">Middleware</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/formats.html">Tabular File Formats</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/formats.html#csv-files">CSV Files</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/formats.html#feather-files">Feather Files</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/formats.html#json-files">JSON Files</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/formats.html#parquet-files">Parquet Files</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/formats.html#orc-files">ORC Files</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/filesystems.html">Filesystems</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/filesystems.html#interface">Interface</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/filesystems.html#concrete-subclasses">Concrete Subclasses</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/dataset.html">Dataset</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/dataset.html#factory-functions">Factory functions</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/dataset.html#classes">Classes</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/plasma.html">Plasma In-Memory Object Store</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/plasma.html#classes">Classes</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/cuda.html">CUDA Integration</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/cuda.html#cuda-contexts">CUDA Contexts</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/cuda.html#cuda-buffers">CUDA Buffers</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/cuda.html#serialization-and-ipc">Serialization and IPC</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | <li class="toctree-l1"><a class="reference internal" href="api/misc.html">Miscellaneous</a><ul> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/misc.html#multi-threading">Multi-Threading</a></li> | 
|  | <li class="toctree-l2"><a class="reference internal" href="api/misc.html#using-with-c-extensions">Using with C extensions</a></li> | 
|  | </ul> | 
|  | </li> | 
|  | </ul> | 
|  | </div> | 
|  | </div> | 
|  |  | 
|  |  | 
|  | </div> | 
|  |  | 
|  |  | 
|  | <div class='prev-next-bottom'> | 
|  |  | 
|  | <a class='left-prev' id="prev-link" href="extending.html" title="previous page">Using pyarrow from C++ and Cython Code</a> | 
|  | <a class='right-next' id="next-link" href="api/datatypes.html" title="next page">Data Types and Schemas</a> | 
|  |  | 
|  | </div> | 
|  |  | 
|  | </main> | 
|  |  | 
|  |  | 
|  | </div> | 
|  | </div> | 
|  |  | 
|  | <script src="../_static/js/index.1c5a1a01449ed65a7b51.js"></script> | 
|  |  | 
|  |  | 
|  | <!-- Matomo --> | 
|  | <script> | 
|  | var _paq = window._paq = window._paq || []; | 
|  | /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ | 
|  | /* We explicitly disable cookie tracking to avoid privacy issues */ | 
|  | _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 --> | 
|  | <footer class="footer mt-5 mt-md-0"> | 
|  | <div class="container"> | 
|  |  | 
|  | <div class="footer-item"> | 
|  | <p class="copyright"> | 
|  | © Copyright 2016-2019 Apache Software Foundation.<br/> | 
|  | </p> | 
|  | </div> | 
|  |  | 
|  | <div class="footer-item"> | 
|  | <p class="sphinx-version"> | 
|  | Created using <a href="http://sphinx-doc.org/">Sphinx</a> 4.0.2.<br/> | 
|  | </p> | 
|  | </div> | 
|  |  | 
|  | </div> | 
|  | </footer> | 
|  | <script type="text/javascript" src="/docs/_static/versionwarning.js"></script>  </body> | 
|  | </html> |