What objects can/should be shared/reused? about databricks-sql-nodejs

[kravets-levko]

Hi @timtucker-dte! So:

1. client instance can be safely used as singleton. Probably the only advice here could be to have an instance per connection options set (host + path + auth creds - things you pass to client.connect()). Depending on your use case, you may call connect() many times on same client, passing different options, but you'd have to close client before second and subsequent connect calls.
2. session could also be used as a singleton, but keep in mind that after some period of inactivity it will expire and you'll start getting error on any operation running against the session.

Both client and session objects should eventually be closed to free up resources they use. When you do this depends on your use case. Client instance itself doesn't expire, and can be used as long as you need. Sessions (as mentioned) will expire if not used. So if, for example, your code executes some queries frequently it makes sense to keep and re-use session object - it will save some time and network requests. If your script runs, say, every hour, - it's better to create a new session each time and close it when script finishes, so you don't have to deal with expired sessions.

Hope this clarifies things a bit, but feel free to ask if any questions

[timtucker-dte]

Thanks!

For a session, how would we tell that it's expired?
Is there an event that we should be listening for / an error that we can catch?
Is there a good way to tell whether or not a session currently has operations pending?

Ideally what we're looking for is the equivalent of what we can get using connection pooling libraries with other SDKs, where most of the object management gets taken care of automatically behind the scenes.

[kravets-levko]

For a session, how would we tell that it's expired?

We cannot until we try to use it. It's a big problem for developers of all connectors, and we don't have anh solution for this so far.

Is there an event that we should be listening for / an error that we can catch?

I need to double-check, but if I recall correctly - you'll just get a HTTP 404 when trying to use an expired session

Is there a good way to tell whether or not a session currently has operations pending?

I'm curiour what's a use case for it?