{"title":"Microsoft SQL Server Connector","nodeType":"Source","id":"*OkUoLHZdXnVkDs_V","factoryName":"org.knime.database.extension.mssql.node.connector.MSSQLDBConnectorNodeFactory2","factoryId":"org.knime.database.extension.mssql.node.connector.MSSQLDBConnectorNodeFactory2","path":["DB","Connection"],"owner":"knime","ownerAccountId":"account:team:b5f0848f-496d-4e6a-b869-fa3532248db7","description":"<p>This node creates a connection to a Microsoft SQL Server, an Azure SQL Database or Azure Synapse SQL pool via its JDBC driver. You need to provide the server&#39;s hostname (or IP address), the port, and a database name. Login credentials can either be provided directly in the configuration, via credential variables or via the dynamic input port.</p>\n        ","shortDescription":"Create a database connection to Microsoft SQL Server.","keywords":["database","db","connection","session","create","mssql"],"deprecated":false,"streamable":true,"tags":["DB","Connection","Streamable"],"icon":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAAN1wAADdcBQiibeAAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAD/SURBVDiNpdFPK0RRHMbxzwwWsxqykchiSilray9BbFhY2NhaziuxsBploWxMKSJvwHZs5JaUkshCiFiwuGeae+/M3C7zq1+n8+97nuc5DFhDYbzGGhZQQvRX0E+mTwLo34AXVIpcHM7Mv3COOj4S6xVsYA5POMSlhMxV3KGF1x4PNXCPA0yhjKPsoRJmsIULjCb2WqjlWYnwqZPBu3SIm3jEHtZ1W+8K8bjHI2NYwRn2+wFusYOJHLXVoIaElHG8iX+BOPURfIf5tjiXBywHFej4rGIas1gKPRmgMI/FYOMKzQQ8ZaHdzzkWUlXus94sCmhncBPkRjjFblHAwPULs1hBmSyDU1sAAAAASUVORK5CYII=","views":[],"inPorts":[],"outPorts":[{"objectClass":"org.knime.database.port.DBSessionPortObject","color":"cc005b","dataType":"DB Session","optional":false,"name":"DB Connection","description":"Microsoft SQL Server DB Connection."}],"dynInPorts":[{"groupName":"Credential (JWT)","groupDescription":"When available the node will set the <i>accessToken</i> JDBC parameter automatically based on the information from the connected Microsoft Authenticator node. Depending on your database setup you might need to specify additional JDBC parameters which are described in the Microsoft documentation.","types":[{"objectClass":"org.knime.credentials.base.CredentialPortObject","color":"4386f7","dataType":"org.knime.credentials.base.CredentialPortObject"}]}],"dynOutPorts":[],"additionalSiteInformation":{"url":"https://update.knime.com/analytics-platform/5.12","trusted":true,"enabledByDefault":true,"name":"KNIME Analytics Platform 5.12 Update Site","version":"5.12.0"},"dialog":[{"sectionName":"Options","fields":[{"name":"Hostname","description":"The hostname (or IP address) of a Microsoft SQL Server server. The corresponding driver URL template variable is <tt>host</tt> .","optional":false},{"name":"Port","description":"The port on which the Microsoft SQL Server server is listening. The default port is 1433. The corresponding driver URL template variable is <tt>port</tt> .","optional":false},{"name":"Database name","description":"The name of the database you want to connect to. The corresponding driver URL template variable is database.","optional":false},{"name":"Authentication type","description":"The type of the used authentication. Available options may vary depending on the database type.\n<ul><li><b>None</b> : No authentication is required.</li><li><b>Username</b> : Username-based authentication. No password required.</li><li><b>Username and Password</b> : Username and password based authentication.</li><li><b>Password</b> : Password based authentication. No username required.</li><li><b>Kerberos</b> : Kerberos ticket based authentication</li></ul>","optional":false},{"name":"Credentials","description":"The credentials used for the authentication.","optional":false},{"name":"Database dialect","description":"Choose the registered database dialect here.","optional":false},{"name":"Use latest driver version available","description":"If selected, upon execution the node will automatically use the driver with the latest (highest) driver version that is available for the current database type. This has the advantage that you do not need to touch the workflow after a driver update. However, the workflow might break in the rare case that the behavior of the driver e.g. type mapping changes with the newer version.","optional":false},{"name":"Database driver","description":"Choose the JDBC driver to connect to the database here. You can select a specific version of the registered drivers via the drop-down list. Additional drivers can be registered via KNIME&#39;s preference page &#34;KNIME -&gt; Databases&#34;.","optional":false},{"name":"JDBC parameters","description":"This tab allows you to define JDBC driver connection parameter. The value of a parameter can be a constant, credential user, credential password or KNIME URL. For more information about the supported driver properties see the <a href=\"https://docs.microsoft.com/en-us/sql/connect/jdbc/setting-the-connection-properties\" rel=\"ugc nofollow noopener noreferrer\">Microsoft SQL Server documentation.</a> .","optional":false},{"name":"Input mapping by name","description":"Columns that match the given name (or regular expression) and database type will be mapped to the specified KNIME type.\n<ul><li><b>Column selection type</b> : The option allows you to select how the column is matched.\n  <ul><li><b>Manual</b> : Use the exact name of the column</li><li><b>Regex</b> : Allow regex expressions to select multiple columns</li></ul></li><li><b>Column name</b> : The name or regex expression.</li><li><b>Database type</b> : SQL type to map from.</li><li><b>Mapping to</b> : Datatype to map to.</li></ul>","optional":false},{"name":"Input mapping by type","description":"Columns that match the given database type will be mapped to the specified KNIME type.\n<ul><li><b>From type</b> : SQL type to map from.</li><li><b>To type</b> : Datatype to map to.</li></ul>","optional":false},{"name":"Output mapping by name","description":"Columns that match the given name (or regular expression) and KNIME type will be mapped to the specified database type.\n<ul><li><b>Column selection type</b> : The option allows you to select how the column is matched.\n  <ul><li><b>Manual</b> : Use the exact name of the column</li><li><b>Regex</b> : Allow regex expressions to select multiple columns</li></ul></li><li><b>Column name</b> : The name or regex expression.</li><li><b>Source type</b> : Datatype to map from.</li><li><b>Mapping to</b> : SQL type to map to.</li></ul>","optional":false},{"name":"Output mapping by type","description":"Columns that match the given KNIME type will be mapped to the specified database type.\n<ul><li><b>From type</b> : Datatype to map from.</li><li><b>To type</b> : SQL type to map to.</li></ul>","optional":false},{"name":"Additional settings","description":"This tab allows you to define KNIME framework properties such as connection handling, advanced SQL dialect settings or logging options. The available properties depend on the selected database type and driver. For more information about the supported parameters see the <a href=\"https://docs.knime.com/latest/db_extension_guide/index.html#advanced-tab\" rel=\"ugc nofollow noopener noreferrer\">KNIME Database Extension Guide.</a>","optional":false}]}],"links":[{"text":"Database documentation","url":"https://docs.knime.com/ap/latest/db_extension_guide/#register-your-own-jdbc-drivers"}],"kudos":[],"kudosCount":0,"bundleInformation":{"bundleVersion":"5.12.0.v202605281010","bundleName":"KNIME database extensions","bundleSymbolicName":"org.knime.database.extensions","bundleVendor":"KNIME AG, Zurich, Switzerland","featureSymbolicName":"org.knime.features.database","featureName":"KNIME Database","featureVersion":"5.12.0.v202606171318","featureVendor":"KNIME AG, Zurich, Switzerland","extensionId":"*0mIkLShcIfCXS7Y-"},"frequentSuccessors":[]}