CData Python Connector for ServiceNow

Build 23.0.8839


General Changes

  • The ROUND function doesn't accept the negative precision values anymore.

  • The returning types of the FDMonth, FDQuarter, FDWeek, LDMonth, LDQuarter, LDWeek functions are changed from Timestamp to Date.
  • The return type of the ABS function will be consistent with the parameter value type.
  • Added DisplayValueColumnName property, which takes a pattern value to format column names for display values when DisplayValue=ALL. By default, the value of the property is '{0}_display_value'.
  • Added support for SQLAlchemy 2.0.
  • Added the new sys_lastresultinfo system table.
  • Added support for Python 3.11 on Windows, Linux and Mac.
  • Removed support for Python 3.7 on Windows and Linux
  • Removed support for the SELECT INTO CSV statement. The core code doesn't support it anymore.
  • Added UploadAttachment as a stored procedure. UploadAttachment can be used to upload a file as an attachment to a specified record. The SP outputs the generated metadata from the uploaded file.
  • Added DownloadAttachment as a stored procedure. DownloadAttachment can be used to download a file attachment from a specific record.
  • Added the Default column to the sys_procedureparameters table.
  • Updated embedded JRE to jre8u345-b01(Linux x64 / MacOS x64) and jre-17.0.5+8(MacOS aarch64).
  • Added the IsPath column to the sys_procedureparameters table.
  • Added support for server-side GROUP BY, HAVING, IS NULL, IS NOT NULL and aggregate functions such as: min, max, avg, sum, count.
  • Added support for Python 3.10 on Windows, Linux, and Mac
  • Added support for Python 3.9 on Mac
  • Added support for Mac M1

  • Removed support for Python 3.6 on Windows and Linux
  • The new OAuthPassowrd authentication method has been added, which will replace the GrantType Password functionality. OAuthPassword requires OAuthClientId, OAuthClientSecret, Username, and Password.

  • OAuthGrantType has been deprecated. Use AuthScheme instead.

  • Column sizes reported by the ServiceNow Metadata API for the columns of type STRING are not taken into consideration anymore because the endpoint is unreliable.
  • Added support to expose the ServiceNow database views as views when the the IncludeDatabaseViews connection property is set to true.
  • Added support for Single Sign On (SSO) connection with PingFederate as the Identity Provider (IdP).
  • Added the GetColumnsMetadata connection property, which controls when and how the driver should get the columns metadata. When setting it to 'OnUse', the driver will execute the table specific metadata calls the first time the table is referenced, provided the metadata for the table in question aren't already cached.
  • Added support for the STRING_SPLIT table-valued function in the CROSS APPLY clause.
  • Added the KeySeq column to the sys_foreignkeys table.
  • Added the new sys_primarykeys system table.
  • Updated the Literal Function Names for relative date/datetime functions. Previously, relative date/datetime functions resolved to a different value when used in the projection as opposed to the predicate. For example: SELECT LAST_MONTH() AS lm, Col FROM Table WHERE Col > LAST_MONTH(). Formerly, the two LAST_MONTH() methods would resolve to different datetimes. Now, they will match.
  • As a replacement for the previous behavior, the relative date/datetime functions in the criteria may have an 'L' appended to them. For example: WHERE col > L_LAST_MONTH(). This will continue to resolve to the same values that were previously calculated in the criteria. Note that the "L_" prefix will only work in the predicate - it not available for the projection.
  • Added support for handling client side formulas during insert / update. For example: UPDATE Table SET Col1 = CONCAT(Col1, " - ", Col2) WHERE Col2 LIKE 'A%'
  • Updated how display sizes are determined for varchar primary key and foreign key columns so they will match the reported length of the column.
  • Non-conditional updates between two columns is now available to all drivers. For example: UPDATE Table SET Col1=Col2
  • Reduced the length to 255 for varchar primary key and foreign key columns.

  • Updated index naming convention to avoid duplicates.
  • Updated implicit and metadata caching to improve performance and support for multiple connections. Old metadata caches are not compatible - you need to generate new metadata caches if you are currently using CacheMetadata.
  • Deprecated Instance connection property.

  • The URL connection property replaces the Instance connection property. The user should now set the base URL of the ServiceNow instance site, instead of the instance Id. For example:
  • The OneLogin method we used previously has been deprecated by OneLogin. We have updated our design to use the latest version of the OneLogin API, which now requires a seperate OAuthClientId and OAuthClientSecret associated with your OneLogin app to be passed in through SSOProperties. The APIKey that was formerly passed in through SSOProperties for OneLogin is removed.
  • OneLogin also no longer uses SSOLoginURL. Instead, Subdomain and AppId should be specified inside the SSOProperties.
  • Deprecated SSOUser, SSOPassword, SSOProvider, OktaAppEmbedLink and OKTAApiToken connection properties.

  • User and Password replaces SSOUser and SSOPassword.
  • Authscheme replaces SSOProvider.
  • SSOLoginURL replaces OktaAppEmbedLink as it is more generic and applicable to other SSO providers.
  • ApiToken replaces OKTAApiToken as it is more generic and applicable to other SSO providers.

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839