onedevatlasBeta
Browse the atlas
AllCAPBTPUI5ABAP
PackagePackagetypeA library you install and call yourself.See every one →What this type is →by SAPby SAPoriginPublished by SAP itself. A visible facet, never an input to a reading — a dormant official plugin reads exactly like a dormant independent one.See every one →

@sap/hana-client

SAP's own Node.js driver for SAP HANA: connect, run SQL and prepared statements, synchronously, through callbacks or as promises, over native client libraries npm installs per platform.

Reaching SAP HANA from Node.js with no framework database layer in between: a connection is opened with connect, statements run with exec, and prepare returns a statement executed with parameters, the same calls available synchronously, through callbacks, or as promises through the package's own extension/Promise.js module. Connection details are passed to the call or taken from a key in the hdbuserstore, so a host, port and password need not sit in the source. The driver is not JavaScript alone: it contains native libraries, npm downloads the ones for every available platform on install, the Node.js driver shipped with the SAP HANA client is 64-bit only, and that client install carries the same driver for a machine that already has it. In a CAP project it is not what runs unless it is asked for, since @cap-js/hana uses hdb by default and adding this package to the dependencies takes precedence over that.

npm151,618/wk

Facts

Latestv2.30.27ReleasedLicenceSEE LICENSE IN developer-license-3_2.txt

Where it sits

Lives in
BTP/BAIP
Provides
Database connectorsCAPBTPDatabase connectorscapabilityConnecting an application’s data model and queries to a database, including the differences in supported queries, types and schema management between database implementations. Changing an existing schema belongs to [schema evolution](capability:schema-evolution).
Serves
CAP

Who is behind it

SAPSAPOrganisationMaintains this
In the atlas: maintains 137, wrote 14@SAPmaintainer

Before choosing this

Conditions

LicenceSAP Developer License Agreement 3.2 CAP§ 1from Database connectorsA covered CAP application uses a connector to copy or persist SAP product data in a non-SAP database product.
  • § 1 License. Productive customer applications are limited to SAP BTP or another SAP-licensed platform, and mass extraction to a non-SAP product is restricted except where solely required for SAP interoperability.

The connector itself does not decide the licence boundary. Section 1 makes the destination and purpose of extraction relevant, including the scoped exception for interoperability with an SAP product.

SAP Developer License Agreement 3.2 CAP →

What it declares

Every artifact

Type
Package
Origin
By SAP
Runtime
Node.js

As a package

Where it runs
does not say
Distributed through
does not say

Connections3

Download
@sap/hana-client connections@sap/hana-clientPROVIDES→ provides1provides stated Connects a Node.js program to SAP HANA and runs SQL and prepared statements against it over the native client libraries, synchronously or asynchronously; under [@cap-js/hana](artifact:cap-js-hana) it takes over from `hdb` as the driver once it is installed. Connect Using the SAP HANA Node.js Interface — SAP Tutorials: https://github.com/sap-tutorials/Tutorials/blob/master/tutorials/hana-clients-node/hana-clients-node.md Connect Using the SAP HANA Node.js Interface — SAP Tutorials, Install from NPM: https://github.com/sap-tutorials/Tutorials/blob/master/tutorials/hana-clients-node/hana-clients-node.md Using SAP HANA Cloud for Production — capire: https://cap.cloud.sap/docs/guides/databases/hanaDatabase connectorsUSED BY← optionally used by2optionally used by derived If: @sap/hana-client is added to the project's dependencies, which then takes precedence over the default driver. The driver the package uses instead of hdb once it is added to the project's dependencies. Through: inverted from its requires edge Using SAP HANA Cloud for Production — capire, other drivers: https://raw.githubusercontent.com/cap-js/docs/main/guides/databases/hana.md@cap-js/hanaifoptionally used by derived If: the hana-cloud-inspector companion connects to a bound HANA Cloud HDI schema Connecting the read-only hana-cloud-inspector companion to the bound HANA Cloud HDI schema. Through: inverted from its requires edge sap-ai-dev-toolkit README: https://github.com/grknylmz/sap-ai-dev-toolkitsap-ai-dev-toolkitif

Install

npm add @sap/hana-client

Derived from the package name. No recipe recorded; the README has the configuration.

History

Latest

v2.30.27

  1. v2.30.24

  2. v2.29.27

  3. v2.29.25

  4. v2.29.23

  5. v2.28.22

  6. v2.28.21

  7. v2.28.20

  8. v2.28.19

  9. v2.28.17

  10. v2.27.24

  11. v2.27.23

  12. v2.27.19

  13. v2.26.26

  14. v2.26.25

  15. v2.26.18

  16. v2.25.31

  17. v2.25.29

  18. v2.25.22

  19. v2.24.26

  20. v2.24.24

  21. v2.24.21

  22. v2.23.27

  23. v2.23.26

  24. v2.23.24

  25. v2.22.32

  26. v2.22.29

  27. v2.22.27

  28. v2.21.31

  29. v2.21.28

  30. v2.21.26

  31. v2.20.23

  32. v2.20.22

  33. v2.20.20

  34. v2.20.15

  35. v2.19.21

  36. v2.19.20

  37. v2.19.18

  38. v2.18.27

  39. v2.18.24

  40. v2.18.22

  41. v2.17.22

  42. v2.17.21

  43. v2.17.14

  44. v2.16.26

  45. v2.16.21

  46. v2.15.22

  47. v2.15.19

  48. v2.15.17

  49. v2.14.24

  50. v2.14.23

  51. v2.14.22

  52. v2.14.18

  53. v2.13.22

  54. v2.13.21

  55. v2.13.13

  56. v2.12.25

  57. v2.12.22

  58. v2.12.20

  59. v2.12.13

  60. v2.11.20

  61. v2.11.14

  62. v2.10.20

  63. v2.10.15

  64. v2.10.13

  65. v2.10.9

  66. v2.9.28

  67. v2.9.23

  68. v2.9.19

  69. v2.8.22

  70. v2.8.20

  71. v2.8.16

  72. v2.7.26

  73. v2.7.23

  74. v2.7.21

  75. v2.7.16

  76. v2.6.64

  77. v2.6.61

  78. v2.6.58

  79. v2.6.54

  80. v2.5.111

  81. v2.5.109

  82. v2.5.105

  83. v2.5.104

  84. v2.5.101

  85. v2.5.86

  86. v2.4.202

  87. v2.4.196

  88. v2.4.167

  89. v2.4.162

  90. v2.4.155

  91. v2.4.151

  92. v2.4.144

  93. v2.4.142

  94. v2.4.139

  95. v2.4.126

  96. v2.3.144

  97. v2.3.134

  98. v2.3.130

  99. v2.3.123

  100. v2.3.119

  101. v2.3.112

  102. v2.3.106

  103. v2.3.21

  104. v2.4.194

  105. v2.4.191

  106. v2.4.182

  107. v2.4.177

  108. v2.4.171

On npm
60,704downloads per week, npm
Weekly downloads for @sap/hana-client26 complete calendar weeks from 2026-04-27 to 2026-10-25; the latest total is 60704.27 Apr – 3 May: 147,8994 May – 10 May: 178,20511 May – 17 May: 153,93018 May – 24 May: 150,82825 May – 31 May: 151,6581 Jun – 7 Jun: 138,2158 Jun – 14 Jun: 154,34515 Jun – 21 Jun: 165,57922 Jun – 28 Jun: 199,22729 Jun – 5 Jul: 174,6236 Jul – 12 Jul: 164,99113 Jul – 19 Jul: 254,79920 Jul – 26 Jul: 308,98127 Jul – 2 Aug: 257,9843 Aug – 9 Aug: 241,16210 Aug – 16 Aug: 252,63117 Aug – 23 Aug: 285,09724 Aug – 30 Aug: 329,40931 Aug – 6 Sept: 304,6317 Sept – 13 Sept: 202,47714 Sept – 20 Sept: 253,78221 Sept – 27 Sept: 292,92828 Sept – 4 Oct: 408,0505 Oct – 11 Oct: 326,53812 Oct – 18 Oct: 149,03219 Oct – 25 Oct: 60,704

Others providing21

Compare all 22 on the Database connectors page →
Database connectors
  1. SAP HANA CloudManaged SAP HANA database service on BTP
  2. PostgreSQL on SAP BTP, hyperscaler optionManaged PostgreSQL from the hyperscaler via a BTP service binding
  3. com.sap.cds:cds-feature-hanaSAP HANA Cloud datasource for CAP Java applications
  4. com.sap.cds:cds-feature-jdbcJDBC runtime for H2 and SQLite in CAP Java
  5. com.sap.cds:cds-feature-postgresqlPostgreSQL datasource for CAP Java applications
  6. com.sap.cds:cds-services-bomMaven bill of materials pinning CAP Java module versions
  7. @cap-js/db-serviceBase service shared by CAP's SQLite, PostgreSQL and HANA services
  8. @cap-js/hanaSAP HANA database service for CAP
  9. @cap-js/postgresPostgreSQL database service for CAP
  10. @cap-js/sqliteSQLite database service for CAP, in memory during development
  11. cap-postgres-btp-connectivityTunnels CAP Node.js to a private PostgreSQL via Cloud Connector
  12. cds-mongodbMongoDB as a CAP database service through Mongoose
  13. @cds-pgroll/postgresCLI for DROP and RENAME schema changes beside @cap-js/postgres
  14. @neoimpulse/cap-js-restore-model-defined-typesCAP plugin casting read values back to CDS model types
  15. @quadrio/cds-db2DB2 adapter for CDS
  16. @sap/cds-hanaDatabase adapter for SAP HANA in CAP
  17. @sap/cdsCAP Node.js runtime
  18. SAP HANASAP's relational database platform, on-premise and in HANA Cloud
  19. cds-pgPostgreSQL adapter for SAP CDS from the SAP Mentors community
  20. cap-snowflakeCAP database adapter for Snowflake with OData V4 support
  21. cds-mysqlMySQL and MariaDB database adapter for CAP

Details

Sources3
npm registrydiscovered here, npm:scope:@sapchecked
The discovery passdiscovered herechecked
npm registry, @sap/hana-clientversion, releases, installsPackage files could not be readnpm tarball exceeds 32 MB document crawl limitchecked

Sources are graph entities: the same page may back several entries, and an unreachable source flags every row that rests on it.

Compatibility and provenance
runtimesnode
latestv2.30.27
first release
releases and cadence109, ~19d median
discovered vianpm registry · npm:scope:@sap, The discovery pass
first seen in the atlas
ecosystem and domainbtp, data-and-persistence
History in the atlas1
  1. First seen.
For your agent
Ref
artifact:sap-hana-client
JSON
/artifacts/sap-hana-client.json
MCP
Connecting an agent