Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

[Please visit the project page at https://github.com/qubole/qds-sdk-py]

Qubole Data Service Python SDK

A Python module that provides the tools you need to authenticate with, and use the Qubole Data Service API.

Installation

Run the following command (may need to do this as root):

$ python setup.py install

This should place a command line utility ‘qds.py’ somewhere in your path

$ which qds.py /usr/bin/qds.py

CLI

qds.py allows running Hive, Hadoop, Pig and Shell commands against QDS. Users can run commands synchronously - or submit a command and check it’s status.

$ qds.py -h # will print detailed usage

Examples:

  1. run a hive query and print the results

    $ qds.py –token ‘xxyyzz’ hivecmd run –query “show tables” $ qds.py –token ‘xxyyzz’ hivecmd run –script_location /tmp/myquery $ qds.py –token ‘xxyyzz’ hivecmd run –script_location s3://my-qubole-location/myquery

  2. pass in api token from bash environment variable

    $ export QDS_API_TOKEN=xxyyzz

  3. run the example hadoop command

    $ qds.py hadoopcmd run streaming -files ‘s3n://paid-qubole/HadoopAPIExamples/WordCountPython/mapper.py,s3n://paid-qubole/HadoopAPIExamples/WordCountPython/reducer.py’ -mapper mapper.py -reducer reducer.py -numReduceTasks 1 -input ‘s3n://paid-qubole/default-datasets/gutenberg’ -output ‘s3n://example.bucket.com/wcout’

  4. check the status of command # 12345678

    $ qds.py hivecmd check 12345678 {“status”: “done”, … }

SDK API

An example Python application needs to do the following:

  1. Set the api_token:

    from qds_sdk.qubole import Qubole

    Qubole.configure(api_token=’ksbdvcwdkjn123423’)

  2. Use the Command classes defined in commands.py to execute commands. To run Hive Command:

    from qds_sdk.commands import *

    hc=HiveCommand.create(query=’show tables’) print “Id: %s, Status: %s” % (str(hc.id), hc.status)

example/mr_1.py contains a Hadoop Streaming example

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qds_sdk-1.0.9-beta.tar.gz (13.4 kB view details)

Uploaded Source

File details

Details for the file qds_sdk-1.0.9-beta.tar.gz.

File metadata

  • Download URL: qds_sdk-1.0.9-beta.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for qds_sdk-1.0.9-beta.tar.gz
Algorithm Hash digest
SHA256 c6079b3547d22257c89228fd3d640a275045a9bfd9984587b93099d407a3b09d
MD5 6884cadad13fe0f1d43e7e15442dd7c6
BLAKE2b-256 0199e92360bd444d14f5f72e478b2e99d265c651ef81379ede7ecc6a4d5c9405

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page