Commit Graph

17 Commits

Author SHA1 Message Date
John Russell
801c32dec3 IMPALA-5583: [DOCS] Document default_join_distribution_mode query option
New page for the query option.

Change-Id: I4ec6213efc46bce0fe07c590841d51c009fb5c84
Reviewed-on: http://gerrit.cloudera.org:8080/7300
Reviewed-by: Mostafa Mokhtar <mmokhtar@cloudera.com>
Tested-by: Impala Public Jenkins
2017-07-10 23:08:12 +00:00
John Russell
717dd73d78 IMPALA-5333: [DOCS] Document Impala ADLS support
Change-Id: Id5a98217741e5d540d9874e9b30e36f01644ef14
Reviewed-on: http://gerrit.cloudera.org:8080/7175
Reviewed-by: Sailesh Mukil <sailesh@cloudera.com>
Reviewed-by: Laurel Hale <laurel@cloudera.com>
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-07-10 17:21:39 +00:00
John Russell
924ddc6e93 [DOCS] Add placeholder for DECIMAL_V2 query option
Currently unsupported, so the topic doesn't go into
detail about behavior.

Change-Id: I7a3bbd0d56da548d8d42e8ef3b71f2c014bc822d
Reviewed-on: http://gerrit.cloudera.org:8080/6596
Reviewed-by: Greg Rahn <grahn@cloudera.com>
Reviewed-by: Dan Hecht <dhecht@cloudera.com>
Tested-by: Impala Public Jenkins
2017-04-11 20:59:04 +00:00
John Russell
ff5d1ceb0d IMPALA-3402: [DOCS] Remove more stray CDH references
A number of 'CDH' by itself were turned into substitution
variables resolving to 'Apache Hadoop'.

Also fixed some stray instances of CDH version numbers.

In some cases, 'CDH' or 'CDH 5' by itself was superfluous and was
just removed.

Change-Id: I979ea73ccaa5873d4108545f18f598072fb5e05f
Reviewed-on: http://gerrit.cloudera.org:8080/6352
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-03-13 22:01:09 +00:00
John Russell
def5355a24 IMPALA-3403: [DOCS] Pare back irrelevant installation info
Take out the path A / path B pages with CM and non-CM installation
techniques for packages and parcels.

Replace with steps for building from source, adapted from
http://impala.apache.org/downloads.html

Change-Id: Ia81b1afbf04b93c322b9829d9e05e7af4243c37c
Reviewed-on: http://gerrit.cloudera.org:8080/6005
Reviewed-by: Jim Apple <jbapple-impala@apache.org>
Tested-by: Impala Public Jenkins
2017-03-10 21:58:04 +00:00
Laurel Hale
ae79288e12 IMPALA-3401 [DOCS] Phase 7 of "Cloudera Manager" removal
Removed the topic "impala_howto_rm.xml" from the build
because it was focused on resource management by using
Cloudera Manager. Commented it out of impala.ditamap,
impala_keydefs.ditamap, and from a reference to it
in shared/impala_common.xml. This removes it
completely from the rendered upstream docs. A later
project will remove the source XML.

Change-Id: I26fc661144ba906828d5f6b5b2ea2eca02693369
Reviewed-on: http://gerrit.cloudera.org:8080/6108
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-03-07 20:06:47 +00:00
John Russell
8b417c6921 IMPALA-3401: [DOCS] Remove blocks of content devoted to CM
Change-Id: I07d56463939fe152c1c6124cc0ad5591337bad6b
Reviewed-on: http://gerrit.cloudera.org:8080/6179
Reviewed-by: Ambreen Kazi <ambreen.kazi@cloudera.com>
Tested-by: Impala Public Jenkins
Reviewed-by: John Russell <jrussell@cloudera.com>
2017-03-01 22:49:32 +00:00
John Russell
446d95eed3 [DOCS] List SCHEDULE_RANDOM_REPLICA in alphabetical order.
Change-Id: I1e5ad55b588b668c4b4dfc700f375e39b2453e28
Reviewed-on: http://gerrit.cloudera.org:8080/5835
Reviewed-by: Lars Volker <lv@cloudera.com>
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-01-31 22:12:40 +00:00
John Russell
6a95f42022 [DOCS] Add doc for MT_DOP query option.
Add info about MT_DOP default to COMPUTE STATS.

Change-Id: Ife2786532b425af6d230074f1c0b5c7dcb2b8a92
Reviewed-on: http://gerrit.cloudera.org:8080/5652
Reviewed-by: Alex Behm <alex.behm@cloudera.com>
Tested-by: Impala Public Jenkins
2017-01-27 23:49:37 +00:00
John Russell
8377b9949c Global search/replace: audience="Cloudera" -> audience="hidden".
For this change to land in master, the audience="hidden" code review
needs to be completed first. Otherwise, the doc build would still work
but the audience="hidden" content would be visible rather than hidden as
desired.

Some work happening in parallel might introduce additional instances of
audience="Cloudera". I suggest addressing those in a followup CR so this
global change can land quickly.

Since the changes apply across so many different files, but are so
narrow in scope, I suggest that the way to validate (check that no
extraneous changes were introduced accidentally) is to diff just the
changed lines:

git diff -U0 HEAD^ HEAD

In patch set 2, I updated other topics marked audience="Cloudera"
by CRs that were pushed in the meantime.

Change-Id: Ic93d89da77e1f51bbf548a522d98d0c4e2fb31c8
Reviewed-on: http://gerrit.cloudera.org:8080/5613
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-01-18 19:31:57 +00:00
John Russell
2665866c16 IMPALA-4643: Centralize <keydef> tags in separate .ditamap
Patch set #2 to bring this gerrit review
up to date with subsequent changes to .ditamap
file in master.

Also incorporate <topicref> and corresponding
<keydef> for SCRATCH_LIMIT query option.

Change-Id: I4d3098356e1b112ba08bfaf7386c3a1f30306223
Reviewed-on: http://gerrit.cloudera.org:8080/5599
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: Impala Public Jenkins
2017-01-13 22:28:28 +00:00
John Russell
6a2c9049ff IMPALA-3671: Add SCRATCH_LIMIT query option.
Clarify comment about # of DataNodes.

Change-Id: I662a59a59da8a170a2710d4a5245363ae1e3f754
Reviewed-on: http://gerrit.cloudera.org:8080/5651
Reviewed-by: Tim Armstrong <tarmstrong@cloudera.com>
Tested-by: Impala Public Jenkins
2017-01-11 23:38:00 +00:00
John Russell
7b1913afbc Apply attribute to hide main data source topic in keydef tag.
Use the same audience= attr as the corresponding topicref tag.

Change-Id: I5c7d3bf9a2a2c3fe73873fea95d025d838e987bb
Reviewed-on: http://gerrit.cloudera.org:8080/5592
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: John Russell <jrussell@cloudera.com>
2017-01-07 00:38:24 +00:00
John Russell
1072d076e4 Make sure 'errata' page is hidden.
The errata page is in an early experimental form and not expected
to be ready for prime time anytime soon. Depends on some
automation that's not practical to put in place during the
transition to Apache infra. That page is chock full of references
to CDH version numbers, so best to make sure it can't possibly
appear in the output.

Using 'Cloudera' condition instead of 'pre-release' to clarify that
the errata topic is experimental and will remain invisible for the
foreseeable future.

Also applying the same attribute to the corresponding <keydef> tag
so the hidden topic doesn't get processed in some unforeseen way.

Will change those conditions to 'hidden' after the other changes
to audience= attributes land.

Change-Id: Id254192b325ba18c415a2cf17e6357800d81c437
Reviewed-on: http://gerrit.cloudera.org:8080/5625
Reviewed-by: Jim Apple <jbapple-impala@apache.org>
Reviewed-by: Ambreen Kazi <ambreen.kazi@cloudera.com>
Tested-by: John Russell <jrussell@cloudera.com>
2017-01-07 00:23:39 +00:00
John Russell
c4ee03a7e5 IMPALA-3401: Suppress blocks of content devoted to Cloudera Manager.
Initial experiment to see how the doc looks & builds when the biggest,
most obvious pieces of Cloudera Manager-related content are suppressed:
- Primarily entire subtopics.
- In some cases, individual notes, paragraphs, and list items.
- Also the CM reference in the reused "cancel" text which showed up
  many times throughout the SQL syntax section.

Just hiding in the output for now, rather than removing from source,
because we might find there's generic material we need to hoist out of
the CM-related subtopics.

Was planning to use audience="hidden" to hide, but since that CR hasn't
landed in master yet, still using audience="Cloudera" for the moment,
and will switch attribute values later.
A little rewording of titles and suppressing smaller elements such as
paragraphs where the CM aspect didn't apply to the entire subtopic.

Change-Id: Ic799f77bc758a1cf40c53fa412bf02d852901a69
Reviewed-on: http://gerrit.cloudera.org:8080/5607
Reviewed-by: Jim Apple <jbapple-impala@apache.org>
Tested-by: John Russell <jrussell@cloudera.com>
2017-01-05 23:55:45 +00:00
Jim Apple
d484d2f684 Add Apache license header to files in doc directory
This now gives a clean RAT check with bin/check-rat-report.py, which
is one way for the Impala community to check compliance with ASF rules
on intellectual property.

Change-Id: I2ad06435f84a65ba126759e42a18fdaf52cd7036
Reviewed-on: http://gerrit.cloudera.org:8080/5232
Reviewed-by: Jim Apple <jbapple-impala@apache.org>
Tested-by: Impala Public Jenkins
Reviewed-by: John Russell <jrussell@cloudera.com>
2016-12-02 23:54:32 +00:00
Jim Apple
3be0f122a5 IMPALA-3398: Add docs to main Impala branch.
These are refugees from doc_prototype. They can be rendered with the
DITA Open Toolkit version 2.3.3 by:

/tmp/dita-ot-2.3.3/bin/dita \
  -i impala.ditamap \
  -f html5 \
  -o $(mktemp -d) \
  -filter impala_html.ditaval

Change-Id: I8861e99adc446f659a04463ca78c79200669484f
Reviewed-on: http://gerrit.cloudera.org:8080/5014
Reviewed-by: John Russell <jrussell@cloudera.com>
Tested-by: John Russell <jrussell@cloudera.com>
2016-11-17 22:38:44 +00:00