Understanding SQL Server Memory-Optimized Tables Hash Indexes

By:   |   Updated: 2013-12-24   |   Comments (6)   |   Related: > In Memory OLTP


Problem

SQL Server 2014 introduces hash indexes for Memory-Optimized tables, but you may not know what they are and the differences between hash indexes and standard SQL Server indexes. Also you may be asking why there are not clustered indexes on Memory-Optimized tables. Keep reading to find the answers.

Solution

We all know the importance of proper indexing on tables. The introduction of hash indexes for Memory-Optimized tables on SQL Server 2014 brings us new possibilities to achieve maximum performance, but there are some considerations. After reading this tip you will understand the pros and cons of this new type of index.

What is a hash index?

Basically, a hash index is an array of N buckets or slots, each one containing a pointer to a row. Hash indexes use a hash function F(K, N) in which given a key K and the number of buckets N , the function maps the key to the corresponding bucket of the hash index. I want to emphasize that the buckets do not store the keys or its hashed value. They only store the memory address in which the data is placed.

What is a hash function?

A hash function is any algorithm that maps data of variable length to data of a fixed length in a deterministic and close to random way. A very simple hash function would be a string that returns its length, so F("John") = 4 and F("Ed") = 2. If we define a hash index of 5 buckets using this function then the pointers that point to "John" and "Ed" are stored at buckets 4 and 2 respectively. The following image will help you understand.

Hash Function

At this point everything seems clear, but what happens when we apply this simple hash function on "Bill"? The length of string "Bill" is 4, so F("Bill") = 4 which is the same as F("John") = 4. Don't get confused, the fact that two keys have the same Hash value doesn't mean the keys are the same. This is called a "collision" and is very common in hash functions. Of course the more collisions a function has the worse a function is because a large number of hash collisions can have a performance impact on read operations. Also collisions may be caused when the number of buckets is too small compared with the number of distinct keys.

SQL Server Hekaton Collision Management

There are many ways to solve hash collisions, but I will focus on how the Hekaton engine handles them.

The way Microsoft has chosen to handle hash collisions is chaining with linked lists. In order to explain this concept I need to show you how data and indexes are organized on Memory-Optimized Tables.

SQL Server Hekaton Hash Indexes and Row Addressing

In my previous tip Overcoming storage speed limitations with Memory-Optimized Tables for SQL Server I briefly explained Hekaton's structure and now it is time to go deeper.

Memory-Optimized tables consist of two structures: indexes and rows. See image below.

Hekaton Table and Indexes

The only way rows are combined into a table is by linking them with index pointers. I mean rows aren't necessarily stored in an orderly fashion. That's why clustered index are nonsense.  On Memory-Optimized tables space is not pre-allocated. Instead when a row is inserted or updated the Hekaton engine allocates space from RAM's heap on the fly. Also you won't find covering indexes because for Memory-Optimized tables all indexes are inherently covered.

SQL Server Hekaton Row Header

To make it simple to understand I will omit some fields of the row header and will focus only on those that are more relevant for this tip.

As the default isolation level for Memory-Optimized tables is SNAPSHOT, it is easy to understand why the row header keeps timestamps of the rows in order to handle optimistic multiversion concurrency.

For new transactions a row is valid if the end timestamp is set to the special value referred as "infinity".

Remember when I told you about chaining to solve collisions?  That's when index pointers for a row header come to light. When a row is inserted and hashes to a non-empty bucket Hekaton links the new row to the existing one by setting a pointer to the new row on the existing one.

Coming back to the previous example, suppose that at timestamp T0 = 10 we insert a row R1 with "John" as the key that maps to bucket number 4.

Row insert

Then at timestamp T1 = 20 we insert a new row R2 with "Bill" as the key that also maps to bucket number 4. To handle this hash collision Hekaton will set a pointer on R1 to R2. See the next image to get a clearer vision of this scenario.

Row Chaining

SQL Server Hekaton Row Chaining and Multiversioning

Now consider that we have the same row R1 whose key hash maps to bucket 4 at timestamp T0 = 10. Next at timestamp T2 = 30 the row R1 is updated. As I told you in my previous tip about Memory-Optimized tables, Hekaton handles updates as a delete followed by an insert, so updates don't modify the existing row data; instead, the engine sets the row end timestamp to T2 which makes the row outdated for new transactions and inserts a new row, R3 containing the updated data with a begin timestamp equal to T3. Look at the image below for a graphical explanation.

Row Chaining and Multiversion

Now putting it all together: whenever a row's key matches an occupied bucket, either if it is a new row or an updated one, it is linked at the end of the pointer chain of the matching bucket.

This brings up this question: How does the engine identify the proper row?

SQL Server Hekaton Row Identification

Suppose we perform the following SELECT statement on a Hash indexed table.

SELECT  *
FROM    Customer
WHERE   CustomerId = 'John'

To identify this row in a Hash indexed table by an INDEX SEEK operation the Hekaton engine uses the following algorithm:

1 - Calculate the bucket in which the key, if exists, should be stored.

To do so, the Engine applies the Hash function H(x) to the search predicate "John", so H("John") = h. Then, to get the bucket number (a number between 0 and BUCKET_COUNT − 1) Hekaton calculates the remainder of the division between h and the number of buckets.  So:

Bucket = H("John")  % BUCKET_COUNT

If you wonder why Hekaton rounds the number of buckets specified on BUCKET_COUNT to the next power of two, here lies the answer: if BUCKET_COUNT is a power of two then the modulo operation can be replaced by a masking operation. In computing, performing a division to obtain the modulo is more expensive (I mean it uses more cycles per instruction) than a masking operation.

Being BUCKET_COUNT is a power of two, the previous formula is rewritten as follows:

Bucket = H("John") & (BUCKET_COUNT -1)

Where & is a bitwise AND operation. You can test this math shortcut by yourself with the following SQL script.

DECLARE @BUCKET_COUNT INT = 8

SELECT 8458 % @BUCKET_COUNT
SELECT 8458 & (@BUCKET_COUNT -1)

2 - After that the Engine checks at the given position if there is a pointer to a row. If so then it checks for a key value match and if the end timestamp isn't set.

3 - If row key doesn't match or end timestamp is set then the engine looks at the row's index pointer.  If pointer is null then the searched key doesn't exist. Otherwise it repeats step 2 until the searched key is found or the end of pointer chain has been reached.

Here you have a flow chart showing these steps.

Flow Chart

Pros and Cons of Hash Indexes in SQL Server Hekaton

Now I will show you with examples in which circumstances Hash indexes are the right choice. Also I will include screen captures with the execution plans so you can see the difference in query cost.

First we need to create our test database

CREATE DATABASE TestDB
ON PRIMARY
  (NAME = TestDB_file1,
    FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\Data\TestDB_1.mdf',
          SIZE = 100MB,          
          FILEGROWTH = 10%),
FILEGROUP TestDB_MemoryOptimized_filegroup CONTAINS MEMORY_OPTIMIZED_DATA
  ( NAME = TestDB_MemoryOptimized,
    FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\Data\TestDB_MemoryOptimized')
LOG ON
  ( NAME = TestDB_log_file1,
    FILENAME = N'C:\Program Files\Microsoft SQL Server\MSSQL12.MSSQLSERVER\MSSQL\Data\TestDB_1.ldf',
          SIZE = 100MB,          
          FILEGROWTH = 10%)
GO

Then we create some sample tables pairs.

USE TestDB
GO
IF OBJECT_ID('dbo.sample_memoryoptimizedtable_Hash','U') IS NOT NULL
    DROP TABLE dbo.sample_memoryoptimizedtable_Hash
GO
CREATE TABLE dbo.sample_memoryoptimizedtable_Hash
(
 c1 int NOT NULL,
 c2 float NOT NULL,
 c3 decimal(10, 2) NOT NULL
CONSTRAINT PK_sample_memoryoptimizedtable_Hash PRIMARY KEY NONCLUSTERED HASH
(
 c1 
)WITH ( BUCKET_COUNT = 1024)
)WITH ( MEMORY_OPTIMIZED = ON , DURABILITY = SCHEMA_AND_DATA )
GO
----------------------------------------------------------------
IF OBJECT_ID('dbo.sample_memoryoptimizedtable_Range','U') IS NOT NULL
    DROP TABLE dbo.sample_memoryoptimizedtable_Range
GO
CREATE TABLE dbo.sample_memoryoptimizedtable_Range
(
 c1 int NOT NULL,
 c2 float NOT NULL,
 c3 decimal(10, 2) NOT NULL
CONSTRAINT PK_sample_memoryoptimizedtable_Range PRIMARY KEY NONCLUSTERED 
(
 c1 ASC
) 
)WITH ( MEMORY_OPTIMIZED = ON , DURABILITY = SCHEMA_AND_DATA )
GO
/*----------------------------------------------------------------*/
/*----------------------------------------------------------------*/
IF OBJECT_ID('dbo.StringTable_Hash','U') IS NOT NULL
    DROP TABLE dbo.StringTable_Hash
GO
CREATE TABLE dbo.StringTable_Hash
(
 PersonID nvarchar(50)  COLLATE Latin1_General_100_BIN2  NOT NULL , 
 Name nvarchar(50)  COLLATE Latin1_General_100_BIN2  NOT NULL,
   CONSTRAINT PK_StringTable_Hash PRIMARY KEY NONCLUSTERED HASH (PersonID) 
 WITH (BUCKET_COUNT = 1024)
) WITH (MEMORY_OPTIMIZED = ON, DURABILITY = SCHEMA_AND_DATA)
GO
----------------------------------------------------------------
IF OBJECT_ID('dbo.StringTable_Range','U') IS NOT NULL
    DROP TABLE dbo.StringTable_Range
GO
CREATE TABLE dbo.StringTable_Range
(
 PersonID nvarchar(50)  COLLATE Latin1_General_100_BIN2  NOT NULL, 
 Name nvarchar(50)  COLLATE Latin1_General_100_BIN2  NOT NULL,
   CONSTRAINT PK_StringTable_Range PRIMARY KEY NONCLUSTERED (PersonID ASC)
) WITH (MEMORY_OPTIMIZED = ON, DURABILITY = SCHEMA_AND_DATA)
GO
/*----------------------------------------------------------------*/
/*----------------------------------------------------------------*/
IF OBJECT_ID('dbo.Composite_Key_Hash','U') IS NOT NULL
    DROP TABLE dbo.Composite_Key_Hash
GO
CREATE TABLE dbo.Composite_Key_Hash
(
 c1 int NOT NULL,
 c2 float NOT NULL,
 c3 decimal(10, 2) NOT NULL
CONSTRAINT PK_Composite_Key_Hash PRIMARY KEY NONCLUSTERED HASH
(
 c1, c2 
)WITH ( BUCKET_COUNT = 1024)
)WITH ( MEMORY_OPTIMIZED = ON , DURABILITY = SCHEMA_AND_DATA )
GO
----------------------------------------------------------------
IF OBJECT_ID('dbo.Composite_Key_Range','U') IS NOT NULL
    DROP TABLE dbo.Composite_Key_Range
GO
CREATE TABLE dbo.Composite_Key_Range
(
 c1 int NOT NULL,
 c2 float NOT NULL,
 c3 decimal(10, 2) NOT NULL
CONSTRAINT PK_Composite_Key_Range PRIMARY KEY NONCLUSTERED 
(
 c1 ASC, c2 ASC
) 
)WITH ( MEMORY_OPTIMIZED = ON , DURABILITY = SCHEMA_AND_DATA )
GO

As you can see each table in the pair has the same structure, but differs on index type.

Now we load some test data.

USE TestDB
GO
INSERT INTO dbo.sample_memoryoptimizedtable_Hash(c1, c2, c3)
  SELECT 1, 1, 1
  UNION ALL
  SELECT 2, 1, 1
  UNION ALL
  SELECT 8, 1, 1
  UNION ALL
  SELECT 3, 1, 1
  UNION ALL
  SELECT 4, 1, 1
  UNION ALL
  SELECT 5, 1, 1
  UNION ALL
  SELECT 6, 1, 1
  UNION ALL
  SELECT 7, 1, 1
--------------------------------------------------
INSERT INTO dbo.sample_memoryoptimizedtable_Range(c1, c2, c3)
  SELECT 1, 1, 1
  UNION ALL
  SELECT 2, 1, 1
  UNION ALL
  SELECT 8, 1, 1
  UNION ALL
  SELECT 3, 1, 1
  UNION ALL
  SELECT 4, 1, 1
  UNION ALL
  SELECT 5, 1, 1
  UNION ALL
  SELECT 6, 1, 1
  UNION ALL
  SELECT 7, 1, 1
/*----------------------------------------------*/
/*----------------------------------------------*/
INSERT INTO dbo.StringTable_Hash(PersonID, Name)
  SELECT 'A101054', 'John'
  UNION ALL
  SELECT 'A184848', 'Tim'
  UNION ALL
  SELECT 'C154887', 'Bill'
  UNION ALL
  SELECT 'B101054', 'Henry'
  UNION ALL
  SELECT 'B109854', 'Douglas'
  UNION ALL
  SELECT 'D101054', 'Charles'
  UNION ALL
  SELECT 'CA01054', 'Ben'
--------------------------------------------------
INSERT INTO dbo.StringTable_Range(PersonID, Name)
  SELECT 'A101054', 'John'
  UNION ALL
  SELECT 'A184848', 'Tim'
  UNION ALL
  SELECT 'C154887', 'Bill'
  UNION ALL
  SELECT 'B101054', 'Henry'
  UNION ALL
  SELECT 'B109854', 'Douglas'
  UNION ALL
  SELECT 'D101054', 'Charles'
  UNION ALL
  SELECT 'CA01054', 'Ben'
/*----------------------------------------------*/
/*----------------------------------------------*/
INSERT INTO dbo.Composite_Key_Hash(c1, c2, c3)
  SELECT 1, 1, 1
  UNION ALL
  SELECT 2, 1, 1
  UNION ALL
  SELECT 8, 1, 1
  UNION ALL
  SELECT 3, 1, 1
  UNION ALL
  SELECT 4, 1, 1
  UNION ALL
  SELECT 5, 1, 1
  UNION ALL
  SELECT 6, 1, 1
  UNION ALL
  SELECT 7, 1, 1
--------------------------------------------------
INSERT INTO dbo.Composite_Key_Range(c1, c2, c3)
  SELECT 1, 1, 1
  UNION ALL
  SELECT 2, 1, 1
  UNION ALL
  SELECT 8, 1, 1
  UNION ALL
  SELECT 3, 1, 1
  UNION ALL
  SELECT 4, 1, 1
  UNION ALL
  SELECT 5, 1, 1
  UNION ALL
  SELECT 6, 1, 1
  UNION ALL
  SELECT 7, 1, 1

Finally we are ready to perform the tests.

  • Hash indexes don't support range searches like <, > and BETWEEN. This is done by an index scan.

    USE TestDB
    GO
    -- Range searches
    SELECT c1
    FROM   dbo.sample_memoryoptimizedtable_Hash
    WHERE  c1 > 4
    SELECT c1
    FROM   dbo.sample_memoryoptimizedtable_Range
    WHERE  c1 > 4
    


    Range Searches

  • Inequality searches are not supported. They perform a table scan.

    USE TestDB
    GO
    -- Equality comparisons
    SELECT c1
    FROM   dbo.sample_memoryoptimizedtable_Hash
    WHERE  c1 = 4
    SELECT c1
    FROM   dbo.sample_memoryoptimizedtable_Range
    WHERE  c1 = 4
    


    Inequality Searches

  • Hash indexes aren't ordered, so an ORDER BY operation will add a SORT step on the execution plan.

    USE TestDB
    GO
    -- ORDER BY operation
    SELECT   c1
    FROM     dbo.sample_memoryoptimizedtable_Hash
    WHERE    c1 = 4 OR c1 = 7
    ORDER BY c1
    SELECT   c1
    FROM     dbo.sample_memoryoptimizedtable_Range
    WHERE    c1 = 4 OR c1 = 7
    ORDER BY c1
    


    ORDER BY Operation

  • With Hash indexes only whole keys can be used to search for a row. For example if you have a table with a composite key like (C1, C2) then searching by C1 will result in an index scan.

    USE TestDB
    GO
    -- Composite Key Behavior
    SELECT c1
    FROM   dbo.Composite_Key_Hash
    WHERE  c1 = 4
    SELECT c1
    FROM   dbo.Composite_Key_Range
    WHERE  c1 = 4
    


    Composite Key Behavior.jpg

  • A corollary of the above is that LIKE comparisons are not supported and will result in an index scan.

    USE [TestDB]
    GO
    SELECT PersonID
    FROM   dbo.StringTable_Hash
    WHERE  PersonID LIKE 'C%'
    SELECT PersonID
    FROM   dbo.StringTable_Range
    WHERE  PersonID LIKE 'C%'


    LIKE Search

Conclusion

Although Hash indexes are a very powerful tool and can be very helpful in some situations, Hash indexing requires more planning than range indexing. In order to take full advantage of Memory-Optimized tables a SQL Server specialist must fully understand the difference between Hash and Range indexes

References
Next Steps


sql server categories

sql server webinars

subscribe to mssqltips

sql server tutorials

sql server white papers

next tip



About the author
MSSQLTips author Daniel Farina Daniel Farina was born in Buenos Aires, Argentina. Self-educated, since childhood he showed a passion for learning.

This author pledges the content of this article is based on professional experience and not AI generated.

View all my tips


Article Last Updated: 2013-12-24

Comments For This Article




Wednesday, April 11, 2018 - 3:25:18 AM - JohnDoe Back To Top (75670)

How come the HASH index in the LIKE comparison has a 1/4th query cost with the index scan opposed to the index seek ?


Monday, August 11, 2014 - 2:19:27 AM - Saeed Back To Top (34077)

Very well explained, well done Daniel. It was so confusing reading about this subject on MSDN, I'm glad I found your post.

Cheers. 


Sunday, February 2, 2014 - 1:16:10 PM - Daniel Farina Back To Top (29312)

Hi Manu

Thank you for reading and commenting!

Best Wishes!


Friday, January 31, 2014 - 4:03:19 AM - manu Back To Top (29291)

Thanks for sharing. Well explained...


Saturday, January 4, 2014 - 12:36:15 PM - Daniel Farina Back To Top (27960)

Hi Mayur!

Thanks to you for reading! Hope you enjoyed this article!

Hash indexes are better than Range indexes for equality comparisons. For example  

SELECT  *

FROM  Table

WHERE IndexedColumn = @Value

 

Or also

 

SELECT  *

FROM  Table

WHERE IndexedColumn IN (@Value1,  @Value2, ...)

 

But there is an issue:

Hash indexes are optimum for equality comparisons IF you use the whole key. Example:

Suppose we have INDEX IX (CustomerID, AccountID)

If IX is a range index, fields are ordered by CustomerID and AccountID.

Therefore you can query the index for a given CustomerID not including the AccountID because data is ordered that way. Also you cant use this index to query AccountID without giving in a CustomerID.

If IX is a hash index you cant do any of those because data is not ordered. A hash index applies a hash function on  CustomerID and AccountID and stores the value into an array position which is the result of applying the function to CustomerID and AccountID .

So when you query for a particular CustomerID and AccountID  the engine applies the same hash function on the given values. Doing this the engine gets the position of the array at which data SHOULD BE if it exists. Therefore if there is data in that array position it should be the queried values.

Hope I was clear enough.

Thank you very much!

Best Regards!


Thursday, January 2, 2014 - 1:40:10 PM - Mayur Back To Top (27939)

Thank you for the article. Really Nice one! I uinderstood when not to use the Hash index but I could not understand the benefits of using it and where to use it.















get free sql tips
agree to terms