ML Community Day is November 9! Join us for updates from TensorFlow, JAX, and more Learn more


A generic hash table that is immutable once initialized.

Inherits From: TrackableResource

Used in the notebooks

Used in the tutorials

Example usage:

keys_tensor = tf.constant(['a', 'b', 'c'])
vals_tensor = tf.constant([7, 8, 9])
input_tensor = tf.constant(['a', 'f'])
table = tf.lookup.StaticHashTable(
    tf.lookup.KeyValueTensorInitializer(keys_tensor, vals_tensor),
array([ 7, -1], dtype=int32)

Or for more pythonic code:

array([ 7, -1], dtype=int32)

The result of a lookup operation has the same shape as the argument:

input_tensor = tf.constant([['a', 'b'], ['c', 'd']])
array([[ 7,  8],
       [ 9, -1]], dtype=int32)

initializer The table initializer to use. See HashTable kernel for supported key and value types.
default_value The value to use if a key is missing in the table.
name A name for the operation (optional).

default_value The default value of the table.
key_dtype The table key dtype.
name The name of the table.
resource_handle Returns the resource handle associated with this Resource.
value_dtype The table value dtype.



View source

Returns tensors of all keys and values in the table.

name A name for the operation (optional).

A pair of tensors with the first tensor containing all keys and the second tensors containing all values in the table.


View source

Looks up keys in a table, outputs the corresponding values.

The default_value is used for keys not present i