summaryrefslogtreecommitdiffstats
path: root/src/arrow/r/man/hive_partition.Rd
diff options
context:
space:
mode:
Diffstat (limited to 'src/arrow/r/man/hive_partition.Rd')
-rw-r--r--src/arrow/r/man/hive_partition.Rd35
1 files changed, 35 insertions, 0 deletions
diff --git a/src/arrow/r/man/hive_partition.Rd b/src/arrow/r/man/hive_partition.Rd
new file mode 100644
index 000000000..eef9f9157
--- /dev/null
+++ b/src/arrow/r/man/hive_partition.Rd
@@ -0,0 +1,35 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/dataset-partition.R
+\name{hive_partition}
+\alias{hive_partition}
+\title{Construct Hive partitioning}
+\usage{
+hive_partition(..., null_fallback = NULL, segment_encoding = "uri")
+}
+\arguments{
+\item{...}{named list of \link[=data-type]{data types}, passed to \code{\link[=schema]{schema()}}}
+
+\item{null_fallback}{character to be used in place of missing values (\code{NA} or \code{NULL})
+in partition columns. Default is \code{"__HIVE_DEFAULT_PARTITION__"},
+which is what Hive uses.}
+
+\item{segment_encoding}{Decode partition segments after splitting paths.
+Default is \code{"uri"} (URI-decode segments). May also be \code{"none"} (leave as-is).}
+}
+\value{
+A \link[=Partitioning]{HivePartitioning}, or a \code{HivePartitioningFactory} if
+calling \code{hive_partition()} with no arguments.
+}
+\description{
+Hive partitioning embeds field names and values in path segments, such as
+"/year=2019/month=2/data.parquet".
+}
+\details{
+Because fields are named in the path segments, order of fields passed to
+\code{hive_partition()} does not matter.
+}
+\examples{
+\dontshow{if (arrow_with_dataset()) (if (getRversion() >= "3.4") withAutoprint else force)(\{ # examplesIf}
+hive_partition(year = int16(), month = int8())
+\dontshow{\}) # examplesIf}
+}