AMashenkov commented on code in PR #858: URL: https://github.com/apache/ignite-3/pull/858#discussion_r891438409
########## docs/_docs/sql/java.adoc: ########## @@ -0,0 +1,68 @@ +// Licensed to the Apache Software Foundation (ASF) under one or more +// contributor license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright ownership. +// The ASF licenses this file to You under the Apache License, Version 2.0 +// (the "License"); you may not use this file except in compliance with +// the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. += Java SQL API + +In your Java projects, you can use the Java SQL API to execute SQL statements and getting results. All operations are executed as a part of sql session. You can create a session with default parameters by using a `sql.createSession()` method, or use an `sql.sessionBuilder` to configure it for your environment. The `execute` method accepts a query String, or a Statement object, that can be created by using `sql.createStatement()` and `sql.statementBuilder()` methods. Review Comment: It worth to mention that, 1. usually, the session is a long-lived object and may hold data on the server-side. In Ignite the session itself is light-weight object and Ignite is able manages server-side resources automatically in failover scenarios (e.g. when client disconnects/reconnects). However, user should keep in mind this fact and close the session (via close() method) manually, when the session no longer needed. Session can be reused in multiple threads. 2. Statement is also a light-weight object and can be reused in multiple threads/sessions. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
