You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "ianmcook (via GitHub)" <gi...@apache.org> on 2023/03/11 22:52:00 UTC

[GitHub] [arrow] ianmcook opened a new issue, #33958: [Format][Docs] Document primitive types in the Arrow format docs

ianmcook opened a new issue, #33958:
URL: https://github.com/apache/arrow/issues/33958

   ### Describe the enhancement requested
   
   It would be nice if the [Arrow columnar format docs page](https://arrow.apache.org/docs/format/Columnar.html) documented what primitive types Arrow supports. It is not great that readers need to go to [format/Schema.fbs](https://github.com/apache/arrow/blob/master/format/Schema.fbs) for that information today.
   
   ### Component(s)
   
   Documentation, Format


-- 
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: issues-unsubscribe@arrow.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] ianmcook closed issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "ianmcook (via GitHub)" <gi...@apache.org>.
ianmcook closed issue #33958: [Format][Docs] Document primitive types in the Arrow format docs
URL: https://github.com/apache/arrow/issues/33958


-- 
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: issues-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] Amishakumari544 commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "Amishakumari544 (via GitHub)" <gi...@apache.org>.
Amishakumari544 commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1442849757

   can somebody tell me where I should add this [Schema](https://github.com/apache/arrow/blob/main/format/Schema.fbs)  in Arrow columnar page?


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] westonpace commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "westonpace (via GitHub)" <gi...@apache.org>.
westonpace commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1443749515

   I'll let @ianmcook answer this as I'm not actually sure what "primitive types" is referring to.  I think, when I marked this, I assumed he was talking about logical types.  Perhaps https://github.com/apache/arrow/issues/14752 would actually be a better starting point.  That issue is about replacing [this paragraph](https://arrow.apache.org/docs/format/Columnar.html#logical-types) with a brief listing of [these types](https://github.com/apache/arrow/blob/main/format/Schema.fbs#L407-L430).  For example, it is not clear in the document that Arrow supports a "boolean" type.  One must refer to the schema to figure this out.  (the document describes the physical layout, "fixed-size primitive", and the schema defines the type "Bool")
   
   Another place we have a listing of logical types is at https://arrow.apache.org/docs/status.html#data-types .  So I think the idea is to just have a listing of data types in the "arrow columnar format" page.


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] ianmcook commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "ianmcook (via GitHub)" <gi...@apache.org>.
ianmcook commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1465043799

   Duplicate of #4752


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] jorisvandenbossche commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "jorisvandenbossche (via GitHub)" <gi...@apache.org>.
jorisvandenbossche commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1447864816

   I think in this context the "primitive types" and "logical types" are meaning the same (confusingly), as we currently only have a section ["Fixed-size Primitive Layout](https://arrow.apache.org/docs/format/Columnar.html#fixed-size-primitive-layout) explaining the layout of primitive types, but not which actual "logical" primitive types we have (whether the term "logical" is correct here is another question).
   
   So essentially I think this issue is about exactly the same as https://github.com/apache/arrow/issues/14752, I think we can close this one as duplicate of https://github.com/apache/arrow/issues/14752? 
   Unless we would like to list just the primitive types that follow the fixed-size primitive layout in that section, instead of listing all types (including those primitive types) in the ["Logical types" section](https://arrow.apache.org/docs/format/Columnar.html#logical-types)?


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] ianmcook commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "ianmcook (via GitHub)" <gi...@apache.org>.
ianmcook commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1465043586

   Closed as dup of #4752


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [arrow] ianmcook commented on issue #33958: [Format][Docs] Document primitive types in the Arrow format docs

Posted by "ianmcook (via GitHub)" <gi...@apache.org>.
ianmcook commented on issue #33958:
URL: https://github.com/apache/arrow/issues/33958#issuecomment-1465043962

   Duplicate of 14752


-- 
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: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org