davisusanibar commented on a change in pull request #12739: URL: https://github.com/apache/arrow/pull/12739#discussion_r839007858
########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. + +Arrow Java provides several building blocks; ``data types`` describe the types of values; +``ValueVectors`` are sequences of typed values; ``fields`` describe the types of columns in +tabular data; ``schemas`` describe a sequence of columns in tabular data and +``VectorSchemaRoot`` represents tabular data. Arrow also provides ``readers`` and +``writers`` for loading data from and persisting data to storage. Review comment: Deleted ########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. + +Arrow Java provides several building blocks; ``data types`` describe the types of values; +``ValueVectors`` are sequences of typed values; ``fields`` describe the types of columns in +tabular data; ``schemas`` describe a sequence of columns in tabular data and +``VectorSchemaRoot`` represents tabular data. Arrow also provides ``readers`` and +``writers`` for loading data from and persisting data to storage. + + +Arrow Java Modules Review comment: Deleted ########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. Review comment: Changed ########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. + +Arrow Java provides several building blocks; ``data types`` describe the types of values; +``ValueVectors`` are sequences of typed values; ``fields`` describe the types of columns in +tabular data; ``schemas`` describe a sequence of columns in tabular data and +``VectorSchemaRoot`` represents tabular data. Arrow also provides ``readers`` and +``writers`` for loading data from and persisting data to storage. + + +Arrow Java Modules +------------------ + +Arrow Java are divided in these modules to offer in-memory columnar data structures: Review comment: Deleted ########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. + +Arrow Java provides several building blocks; ``data types`` describe the types of values; +``ValueVectors`` are sequences of typed values; ``fields`` describe the types of columns in +tabular data; ``schemas`` describe a sequence of columns in tabular data and +``VectorSchemaRoot`` represents tabular data. Arrow also provides ``readers`` and +``writers`` for loading data from and persisting data to storage. + + +Arrow Java Modules +------------------ + +Arrow Java are divided in these modules to offer in-memory columnar data structures: + +.. list-table:: Arrow Java Modules + :widths: 25 50 25 + :header-rows: 1 + + * - Module + - Description + - Root Decision Review comment: Changed ########## File path: docs/source/java/overview.rst ########## @@ -0,0 +1,218 @@ +.. Licensed to the Apache Software Foundation (ASF) under one +.. or more contributor license agreements. See the NOTICE file +.. distributed with this work for additional information +.. regarding copyright ownership. The ASF licenses this file +.. to you under the Apache License, Version 2.0 (the +.. "License"); you may not use this file except in compliance +.. with the License. You may obtain a copy of the License at + +.. http://www.apache.org/licenses/LICENSE-2.0 + +.. Unless required by applicable law or agreed to in writing, +.. software distributed under the License is distributed on an +.. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +.. KIND, either express or implied. See the License for the +.. specific language governing permissions and limitations +.. under the License. + +.. default-domain:: java +.. highlight:: java + +=================== +High-Level Overview +=================== + +.. contents:: + +Arrow Java modules is created using specification such as Columnar Format, Off-Heap +Memory, Serialization and Inter Process Communication (IPC). Some of the Java modules +was created with their own native implementations and others through bindings. + +Arrow Java provides several building blocks; ``data types`` describe the types of values; +``ValueVectors`` are sequences of typed values; ``fields`` describe the types of columns in +tabular data; ``schemas`` describe a sequence of columns in tabular data and +``VectorSchemaRoot`` represents tabular data. Arrow also provides ``readers`` and +``writers`` for loading data from and persisting data to storage. + + +Arrow Java Modules +------------------ + +Arrow Java are divided in these modules to offer in-memory columnar data structures: + +.. list-table:: Arrow Java Modules + :widths: 25 50 25 + :header-rows: 1 + + * - Module + - Description + - Root Decision + * - arrow-format + - Generated Java files from the IPC Flatbuffer definitions. + - Native implementation + * - arrow-memory-core + - Core off-heap memory management libraries for Arrow ValueVectors. + - Native implementation + * - arrow-memory-unsafe + - Allocator and utils for allocating memory in Arrow based on sun.misc.Unsafe. + - Native implementation + * - arrow-memory-netty + - Netty allocator and utils for allocating memory in Arrow. + - Native implementation + * - arrow-vector + - An off-heap reference implementation for Arrow columnar data format. + - Native implementation + * - arrow-tools + - Java applications for working with Arrow ValueVectors. + - Native implementation + * - arrow-jdbc + - (Experimental) A library for converting JDBC data to Arrow data. + - Native implementation + * - arrow-plasma + - (Experimental) Java client for the Plasma object store. + - Native implementation + * - flight-core + - (Experimental) An RPC mechanism for transferring ValueVectors. + - Native implementation + * - flight-grpc + - (Experimental) Contains utility class to expose Flight gRPC service and client. + - Native implementation + * - flight-sql + - (Experimental) Contains utility classes to expose Flight SQL semantics for clients and servers over Arrow Flight. + - Native implementation + * - flight-integration-tests + - Integration tests for Flight RPC. + - Native implementation + * - arrow-performance + - JMH Performance benchmarks for other Arrow libraries. + - Native implementation + * - arrow-algorithm + - (Experimental) A collection of algorithms for working with ValueVectors. + - Native implementation + * - arrow-avro + - (Experimental) A library for converting Avro data to Arrow data. + - Native implementation + * - arrow-compression + - (Experimental) A library for working with the compression/decompression of Arrow data. + - Native implementation + * - arrow-c-data + - Java implementation of C Data Interface + - Bindings + * - arrow-orc + - (Experimental) A JNI wrapper for the C++ ORC reader implementation. + - Bindings + * - arrow-gandiva + - Java wrappers around the native Gandiva SQL expression compiler. + - Bindings + * - arrow-dataset + - Java implementation of Arrow Dataset API/Framework + - Bindings + +Arrow Java modules offer support to work data (1) in-memory, (2) at rest and (3) on-the-wire. + +For more detail about how to install this modules please review +:doc:`Installing Java Modules <install>`. Review comment: Deleted -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
