Blog

Unlock Aerospike Cloud: Exploring the power of the Aerospike LINQPad driver

Author's photo
Richard Andersen
Principal Engineer
February 27, 2024|4 min read

This blog is part of a continuing series showing how to use the Aerospike LINQPad driver. For other blogs in this series, please see:

The Aerospike LINQPad driver is now able to connect to the Aerospike Cloud, providing all the power of LINQPad combined with the Aerospike LINQPad driver.

This includes a graphical interface, LINQ support, and enhanced driver features to support the Aerospike Database. Find more information about LINQPad here.

Let’s look at the new connection dialog and some of the features of the LINQPad driver.

Connection dialog

The new connection dialog will now have two tabs. The first tab will be for native, “self-managed”, Aerospike clusters, and the second tab is used to connect to Aerospike Cloud.

Below shows the connection properties:

unlock-aerospike-cloud-exploring-the-power-of-the-aerospike-linqpad-driver-connection-dialog 1709081474856

Aerospike Cloud connection dialog

A review of each property is below:

  1. The host name is provided in the cloud dashboard. The hyperlink will take you to the Aerospike login screen or, if you are already logged in, to the dashboard.

  2. The cloud client connection port.

  3. If a VPC (AWS private link) is defined, this would be the host name displayed on the cloud dashboard. The host name field would be the VPC endpoint.

  4. The API key is created via the dashboard.

  5. If the API key and secret were exported from the dashboard to your local machine, this button will allow you to import that API Key CSV file. Properties “API Key” (item 4) and “API Secret” (item 7) are not required.

  6. If enabled, the built-in LINQPad password manager is used. When enabled, a dropdown will be displayed to select the Password Name you defined in the manager. The Password Manager can be found on the File menu of LINQPad.

  7. The associated API Key’s secret.

  8. If checked, it will show the API secret in plain text.

  9. The associated cloud namespace.

  10. If provided, a list of set names separated by a comma or space. The set names will be used to populate the sets under the namespace in the LINQPad connection tree (see below image). Also, set and bin “detection” will be performed to obtain the bins and data types. Regardless of whether this field is provided, you can always obtain this information from the “Null Set.” See the “Using Null Set” section below.

  11. Hyperlinks to additional topics.

  12. The timeout values that will be used when obtaining the connection or performing an operation. Note that the “Sleep” field is ignored for cloud connections.

Below shows the relationship between the “set names” connection property and the LINQPad connection tree:

unlock-aerospike-cloud-exploring-the-power-of-the-aerospike-linqpad-driver-connection-tree-set-names 1709081474940

Association between the “Set Names” property and the sets populated in the connection tree

Driver overview

All the features of the Aerospike LINQPad driver are available, including the following:

  • Graphical interface with all LINQPad features

  • Drag-and-drop of set names

  • LINQ

  • Serialize and deserialize any C# object via the Object-Mapper (POCO)

  • Auto-Values, which provide dynamic data type conversion from Aerospike types to .Net types without testing or casting

  • JSON support

  • Explore the Aerospike API directly or use the driver’s enhanced API

unlock-aerospike-cloud-exploring-the-power-of-the-aerospike-linqpad-driver-2 1709081474438unlock-aerospike-cloud-exploring-the-power-of-the-aerospike-linqpad-driver-1 1709081473558

Demonstrates some of the capabilities of LINQPad and the LINQPad driver

Using the Aerospike null set

If the “Set Names” connection property is not provided, the set and bin names will not be provided in the LINQPad connection tree (see image above). You can still perform queries and API calls using the driver’s API features. Below is an example of a driver API call to obtain the records for Aerospike set “Artist”:

aerospike_cloud.NullSet.Where(ns => ns.Aerospike.SetName == "Artist")

Below is the output:

unlock-aerospike-cloud-exploring-the-power-of-the-aerospike-linqpad-driver-extended-api 1709081475084

Result using the driver’s extended API for set “Artist”

You can always extend the “where” clause or interact with the result set.

Samples

You can find samples for Aerospike LINQPad Cloud under the samples folder or under the “Samples” tab in LINQPad.

Review

In this installment of the Aerospike LINQPad driver blog series, we learned how to use LINQPad to connect to Aerospike Cloud. This connection makes exploring your data in the cloud just as easy as other deployment options. Stay tuned for more articles in this series highlighting additional features of the driver.