From user-return-539-archive-asf-public=cust-asf.ponee.io@arrow.apache.org Tue Jul 21 15:12:20 2020 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mailroute1-lw-us.apache.org (mailroute1-lw-us.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with ESMTPS id 193F518065B for ; Tue, 21 Jul 2020 17:12:20 +0200 (CEST) Received: from mail.apache.org (localhost [127.0.0.1]) by mailroute1-lw-us.apache.org (ASF Mail Server at mailroute1-lw-us.apache.org) with SMTP id 4FDB212653D for ; Tue, 21 Jul 2020 15:10:19 +0000 (UTC) Received: (qmail 95934 invoked by uid 500); 21 Jul 2020 15:10:18 -0000 Mailing-List: contact user-help@arrow.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: user@arrow.apache.org Delivered-To: mailing list user@arrow.apache.org Received: (qmail 95920 invoked by uid 99); 21 Jul 2020 15:10:18 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 21 Jul 2020 15:10:18 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id 3BB6AC022E for ; Tue, 21 Jul 2020 15:10:18 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: 0 X-Spam-Level: X-Spam-Status: No, score=0 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.2, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=disabled Authentication-Results: spamd1-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-ec2-va.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id T5Ou7l6ELPkI for ; Tue, 21 Jul 2020 15:10:14 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=209.85.215.172; helo=mail-pg1-f172.google.com; envelope-from=neal.p.richardson@gmail.com; receiver= Received: from mail-pg1-f172.google.com (mail-pg1-f172.google.com [209.85.215.172]) by mx1-ec2-va.apache.org (ASF Mail Server at mx1-ec2-va.apache.org) with ESMTPS id 8FBECBB94A for ; Tue, 21 Jul 2020 15:10:14 +0000 (UTC) Received: by mail-pg1-f172.google.com with SMTP id o13so12083378pgf.0 for ; Tue, 21 Jul 2020 08:10:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=k7pmFdVgQNT9MiyaY84L/gHIk869A9ya8PHd8uNa2g0=; b=OupN1M6hES+CpWkiiXRq7/6lpp09hVwopc2nDnROLzEKzLYawPlpVm/yZDrqUfLS3K 7dFxvZgvbG3F9/lTe0yvf5V5HXrqrYSJQUmUG4F+NR4VA173i5yF0YsqmEFPQZFoA6xl 95HjUthSOaQzVZ3YzqdZe/etKgCDN45lKTNffUOMem592uyelnelFrUHmd2Q71l+aZPb sjXopxeBLumt1jc7Pws0M/5FLnzMMr6l312FU4FtBRMd+Ell24GdKqJl8LZDE+nevruC X1SD2D5N6RoRhpNFl0K1whJyZ6IUE+TB+RaJh+7hfdDgFWklptImUOnOdf37yJ/GouHr /OUg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=k7pmFdVgQNT9MiyaY84L/gHIk869A9ya8PHd8uNa2g0=; b=fRlQ3DFZmAsCU9W5HLaFwyjbTQS2j1HgV++V6icFpQk+xS4oikSLEm9y6byNuXjCJs RZEwLPXSww7S15VkHydTSrXhlB/AhoICVZAXt8YiSJzlP0MwKFU31bDSWmWrPGNOVAkn SyF1UBOHuoeNzwzMVXjP0UVgE1dAprbh8BClmy8gE8A1Fn6x+edyC6xz6xWQQllqyTly YUhlbJaJ8EiuRKLFlkoQYdUyuNS5b46Ld5dOruE35aRT1lOyTkCMmVVKoonE5sq9Azy1 GfIBKIezGrlIkOJnQZvZ0utwYMuGJVnGR0n9/kzj5yzMrpCH+6W/1xN8V8i9RXAVHjIJ TNEQ== X-Gm-Message-State: AOAM533iH7MV/Knt3QZW/3zRRA/H108xtosuAu7I/l20KLeK2Rb60w6i uYRePB3EkB0rZchllIPGib5axDRpVDnmilLldeE1/YaTXAg= X-Google-Smtp-Source: ABdhPJyO3R1CXm6h8gCmS6GiKQl5meSp4mzcAS469p8T81X4GZ8ObIe3gxDONgxuuW0dbJaZpdXv7cYloSaPnGoxvMc= X-Received: by 2002:a62:3382:: with SMTP id z124mr3553668pfz.309.1595344207848; Tue, 21 Jul 2020 08:10:07 -0700 (PDT) MIME-Version: 1.0 References: <5F081FAD.06D5E3.03537@seu.edu.cn> <090568C0-34C3-464A-8BE8-2DAA153664F5@trendminer.com> In-Reply-To: From: Neal Richardson Date: Tue, 21 Jul 2020 08:09:56 -0700 Message-ID: Subject: Re: How to get started with using the Arrow Java API? To: user@arrow.apache.org Content-Type: multipart/alternative; boundary="000000000000cdaa4c05aaf5049c" --000000000000cdaa4c05aaf5049c Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Hi Joris, The existing prose Java documentation is in https://github.com/apache/arrow/tree/master/docs/source/java, so I'd imagine that's where you'd want to put any additional content. Neal On Tue, Jul 21, 2020 at 1:55 AM Joris Gillis wrote: > Hi Neal > > I would definitely like to help out with the documentation. Let me check > the copyright agreement with InfoQ. > > In the meanwhile, could you point me in the right direction to contribute > documentation? > > Thanks > Joris > > On 20 Jul 2020, at 17:03, Neal Richardson > wrote: > > Hi Joris, > Since you've written up some nice prose documentation for the Java API, > would you be interested in contributing it, or selections of it, to the > official project documentation? It looks like it would be a valuable > addition. > > Neal > > On Mon, Jul 20, 2020 at 1:31 AM Joris Gillis > wrote: > >> Hi Xiaozhen >> >> Sorry in advance for the self-promotion. >> >> I had the same issue, hence I wrote down what I figured out about the >> Java API in this blog post: >> https://www.infoq.com/articles/apache-arrow-java/ >> >> Another blog post can be found here: >> https://github.com/animeshtrivedi/blog/blob/master/post/2017-12-26-arrow= .md >> >> And last but not least, there is some more documentation inside the >> source code: https://github.com/apache/arrow/tree/master/java >> In particular: >> - https://arrow.apache.org/docs/java/vector.html >> - https://arrow.apache.org/docs/java/vector_schema_root.html >> are good starting points for exploring the API. >> >> Best regards >> Joris >> >> On 10 Jul 2020, at 09:58, =E5=88=98=E6=99=93=E8=87=BB = wrote: >> >> Hi, >> >> I=E2=80=99m a contributor to the Texera (https://github.com/Texera/texer= a) >> project, which is an online big data analytics system providing visual a= nd >> interactive workflow. Current we=E2=80=99re trying to use Arrow in our s= ystem (now >> we=E2=80=99re trying arrow for transferring data between JVM and a pytho= n process, >> but maybe eventually we will adopt Arrow throughout our system). >> However, there seem to be very few tutorials regarding the Java API of >> Arrow, and the documentation provided by Arrow=E2=80=99s official websit= e only has >> Maven JavaDoc, which is not very informative as a starting point. >> So where can I find the kind of documentation like that of C++ and Pytho= n >> API where many examples are shown? I=E2=80=99ve noticed there are a few = pages like >> this for Java (https://arrow.apache.org/docs/java/ipc.html), but these >> pages are not indexed and can only be discovered by searching. Is this >> something that is being worked on? >> >> Thank you. >> >> Best, >> Xiaozhen Liu >> >> >> > --000000000000cdaa4c05aaf5049c Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Joris,
The existing prose Java documenta= tion is in https://github.com/apache/arrow/tree/master/docs/source/java, = so I'd imagine that's where you'd want to put any additional co= ntent.

Neal

On Tue, Jul 21, 2020 at 1:55 = AM Joris Gillis <joris.gi= llis@trendminer.com> wrote:
Hi Neal
I would definitely like to help out with the documentation. Le= t me check the copyright agreement with InfoQ.=C2=A0

In the meanwhile, could you point me in the right direction to contribut= e documentation?

Thanks
Joris
=

On 20 Jul 2020, at 17:03, Neal Rich= ardson <neal.p.richardson@gmail.com> wrote:

=
Hi Joris,
Since you've written up some nice prose docume= ntation for the Java API, would you be interested in contributing it, or se= lections of it, to the official project documentation? It looks like it wou= ld be a valuable addition.

Neal
On Mon, J= ul 20, 2020 at 1:31 AM Joris Gillis <joris.gillis@trendminer.com> wrote:
Hi Xiaozhen
Sorry in advance for the self-promotion.=C2=A0
=
I had the same issue, hence I wrote down what I figured out = about the Java API in this blog post:=C2=A0https://www.infoq.com/artic= les/apache-arrow-java/


=
And last but not least, there is some more documentation inside the so= urce code:=C2=A0https://github.com/apache/arrow/tree/master/java
In particular:=C2=A0
are good starting poin= ts for exploring the API.

Best regards
J= oris

On 10 Jul 2020, at 0= 9:58, =E5=88=98=E6=99=93=E8=87=BB <jamie@seu.edu.cn> wrote:

Hi,
=C2=A0
I=E2=80=99m a contributor to the Texera (https://github.com/Texera/texera) project, which is an online big dat= a analytics system providing visual and interactive workflow. Current we=E2= =80=99re trying to use Arrow in our system (now we=E2=80=99re trying arrow = for transferring data between JVM and a python process, but maybe eventuall= y we will adopt Arrow throughout our system).
However, there= seem to be very few tutorials regarding the Java API of Arrow, and the doc= umentation provided by Arrow=E2=80=99s official website only has Maven Java= Doc, which is not very informative as a starting point.
So w= here can I find the kind of documentation like that of C++ and Python API w= here many examples are shown? I=E2=80=99ve noticed there are a few pages li= ke this for Java (https://arr= ow.apache.org/docs/java/ipc.html), but these pages are not indexed and = can only be discovered by searching. Is this something that is being worked= on?
=C2=A0
Thank you.
=C2=A0
Best,
Xiaozhen Li= u


--000000000000cdaa4c05aaf5049c--