Details

    • Type: Sub-task Sub-task
    • Status: Resolved
    • Priority: Major Major
    • Resolution: Fixed
    • Affects Version/s: 0.13.0
    • Fix Version/s: 0.13.0
    • Component/s: Documentation
    • Labels:
      None

      Description

      ACID introduces a number of new config file options, tables in the metastore, keywords in the grammar, and a new interface for use of tools like storm and flume. These need to be documented.

      1. hive-6541.txt
        14 kB
        Alan Gates
      2. hive-6541-firstEdit.rtf
        18 kB
        Lefty Leverenz
      3. hive-6541-changesAfterFirstEdit.rtf
        32 kB
        Alan Gates

        Issue Links

          Activity

          Hide
          Alan Gates added a comment -

          Lefty Leverenz I have a first draft of the docs. Should I just post it in here in text format so we can iterate on it then I can post it to JIRA when this stuff gets committed?

          Show
          Alan Gates added a comment - Lefty Leverenz I have a first draft of the docs. Should I just post it in here in text format so we can iterate on it then I can post it to JIRA when this stuff gets committed?
          Hide
          Lefty Leverenz added a comment -

          Should I just post it in here in text format

          Sounds good to me. Is it pretty much the same as InsertUpdatesinHive.pdf (attached to HIVE-5317)?

          Show
          Lefty Leverenz added a comment - Should I just post it in here in text format Sounds good to me. Is it pretty much the same as InsertUpdatesinHive.pdf (attached to HIVE-5317 )?
          Hide
          Alan Gates added a comment -

          Here's a .txt draft. No, it's quite different then the pdf attached to 5317. This is intended to be user facing documentation, whereas 5317 is a design doc.

          Show
          Alan Gates added a comment - Here's a .txt draft. No, it's quite different then the pdf attached to 5317. This is intended to be user facing documentation, whereas 5317 is a design doc.
          Hide
          Lefty Leverenz added a comment -

          Thanks, I've made a copy and I'll review it this evening.

          Show
          Lefty Leverenz added a comment - Thanks, I've made a copy and I'll review it this evening.
          Hide
          Lefty Leverenz added a comment -

          Attaching an rtf file with color-coded edits. (Hope you like Mac orchid.) Looks good to me, just a few suggestions and confusions.

          Show
          Lefty Leverenz added a comment - Attaching an rtf file with color-coded edits. (Hope you like Mac orchid.) Looks good to me, just a few suggestions and confusions.
          Hide
          Alan Gates added a comment -

          Alright, I edited based on your comments and submitted an updated version. Assuming you're ok with this how do I actually update the docs? Is it still all on wiki or have we started moving to something managed (I lost track of where we were in that conversation).

          Also, I still need to fill in the interface spec for streaming agents, but I should be able to do that soon.

          Show
          Alan Gates added a comment - Alright, I edited based on your comments and submitted an updated version. Assuming you're ok with this how do I actually update the docs? Is it still all on wiki or have we started moving to something managed (I lost track of where we were in that conversation). Also, I still need to fill in the interface spec for streaming agents, but I should be able to do that soon.
          Hide
          Lefty Leverenz added a comment -

          All docs are on the wiki, diverging further & further from the files converted in 2012.

          This might belong in the User Docs section on the wiki's home page, or in the Language Manual. Or both can link to the same doc for maximum visibility.

          After you've created the ACID wikidoc, I can change the DDL and Configuration docs (with links and version notes, of course). What else? The Locks doc will need a link and maybe a small section. Possibly the ORC doc. Others might occur to me as I review your new draft. Will Streaming Ingest need a link from the Admin docs?

          Quick ref:

          Show
          Lefty Leverenz added a comment - All docs are on the wiki, diverging further & further from the files converted in 2012. This might belong in the User Docs section on the wiki's home page, or in the Language Manual. Or both can link to the same doc for maximum visibility. After you've created the ACID wikidoc, I can change the DDL and Configuration docs (with links and version notes, of course). What else? The Locks doc will need a link and maybe a small section. Possibly the ORC doc. Others might occur to me as I review your new draft. Will Streaming Ingest need a link from the Admin docs? Quick ref: User Documentation Language Manual DDL SHOW ALTER TABLE or PARTITION Configuration Properties Locking ORC Files Administrator Documentation
          Hide
          Alan Gates added a comment -

          I've added page links for Hive Transactions and Streaming Ingest and linked the Hive Transactions page in the User docs section of the wiki home page. Feel free to edit or move these docs around if you think they would be better placed somewhere else.

          Show
          Alan Gates added a comment - I've added page links for Hive Transactions and Streaming Ingest and linked the Hive Transactions page in the User docs section of the wiki home page. Feel free to edit or move these docs around if you think they would be better placed somewhere else.
          Hide
          Lefty Leverenz added a comment -

          The DDL and Configuration Properties docs have been updated, and the Locking design doc has a section that refers to Hive Transactions.

          Show
          Lefty Leverenz added a comment - The DDL and Configuration Properties docs have been updated, and the Locking design doc has a section that refers to Hive Transactions. DDL Alter Table/Partition Compact Show Locks Show Transactions Show Compactions Configuration Properties – Transactions and Compactor Locking – Locking in Hive Transactions

            People

            • Assignee:
              Alan Gates
              Reporter:
              Alan Gates
            • Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development