Skip to content

datayoga-io/livy-client

 
 

Repository files navigation

Livy Client

Simple event driven REST client for Apache Livy

Installation

npm install livy-client

Usage

const LivyClient = require('livy-client')

const start = async () => {

	// Create client
	const livy = new LivyClient({
		host: 'localhost',
		port: '8998'
	})

	// Get sessions
	const sessions = await livy.sessions()
	for (session of sessions) {
		const status = await session.status()
		console.log(`Session id: ${status.id}, state: ${status.state}`)
	}

	// Create session
	const newSession = await livy.createSession({
		kind: 'pyspark',
		numExecutors: 4
	})

	// Listen event of a session
	newSession
		.on('starting', status => {
			console.log('Session starting... ' + status.log.slice(0, -1).slice(-1)[0].replace(/\n/g, ' '))
		})
		// Once ready, execute a code and kill the session
		.once('idle', async status => {
			const statement = await newSession.run({code: 'from time import sleep; sleep(5); print(spark)'})
			statement
				.on('running', status => {
					console.log(`Statement running... ${Math.round(status.progress*100)}/100%`)
				}).once('available', response => {
					console.log(`Statement completed. Result: `)
					console.log(response.output)
					newSession.kill()
				})
		})

}

start()

Reference

Class: LivyClient

Events

  • update
  • requestError

Methods

  • sessions()
  • createSession()
  • stopUpdate()
  • startUpdate()
  • Batch()
// Constructor
const livy = new LivyClient({
	protocol: 'http',
	host: 'localhost',
	port: 8998,
	updateInterval: 1000
})

// Methods
const sessions = await livy.sessions() 			// array of Session instances

const newSession = await livy.createSession({ 	// Session instance
	kind,
	proxyUser,
	jars,
	pyFiles,
	files,
	driverMemory,
	driverCores,
	executorMemory,
	executorCores,
	numExecutors,
	archives,
	queue,
	name,
	conf,
	heartbeatTimeoutInSecond
})

const Batch = livy.Batch()

Class: Session

Events

  • update
  • not_started
  • starting
  • idle
  • busy
  • shutting_down
  • error
  • dead
  • success

Methods

  • status()
  • state()
  • log()
  • statements()
  • run()
  • kill()
  • stopUpdate()
  • startUpdate()
const session = await livy.createSession({kind: 'pyspark3', numExecutors: 4})

// Methods
session.once('idle', async stat => {

	const status = await session.status()	// status object
	const state = await session.state()	// state object
	const log = await session.log()	// array of logs
	const statements = await session.statements()	// array of Statement instances
	const run = await session.run({code: 'print("Hello, World!!")'})	// Statement instance
	const kill = await session.kill()	// result object

})

Class: Statement

Events

  • update
  • waiting
  • running
  • available
  • error
  • cancelling
  • cancelled

Methods

  • status()
    • Returns: Promise
    • {id: int, code: string, state: string, output: object}
  • cancel()
    • Returns: Promise
    • {msg: 'cancelled'}
  • stopUpdate()
  • startUpdate()
const statement = await session.run({code: 'print("Hello, World!!")'})

// Methods
statement.once('running', async status => {
	console.log(status.progress)
	await statement.cancel()									// result object
}).once('available', res => {
	console.log(res.output)
}).once('cancelled', res => {
	console.log(res)
})

Class: Batch

Events

  • update
  • requestError

Methods

  • sessions()
  • createSession()
  • stopUpdate()
  • startUpdate()

Class: BatchSession

Events

  • update
  • not_started
  • starting
  • idle
  • busy
  • shutting_down
  • error
  • dead
  • success

Methods

  • status()
  • state()
  • log()
  • kill()
  • stopUpdate()
  • startUpdate()

About

Simple REST client for Apache Livy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 94.5%
  • Dockerfile 5.1%
  • JavaScript 0.4%