# tf.compat.v1.data.make_initializable_iterator

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.13.1/tensorflow/python/data/ops/dataset_ops.py#L4275-L4318) |

Creates an iterator for elements of `dataset`.

    tf.compat.v1.data.make_initializable_iterator(
        dataset, shared_name=None
    )

<br />

## Migrate to TF2

<br />

> [!CAUTION]
> **Caution:** This API was designed for TensorFlow v1. Continue reading for details on how to migrate from this API to a native TensorFlow v2 equivalent. See the [TensorFlow v1 to TensorFlow v2 migration guide](https://www.tensorflow.org/guide/migrate) for instructions on how to migrate the rest of your code.

This is a legacy API for consuming dataset elements and should only be used
during transition from TF 1 to TF 2. Note that using this API should be
a transient state of your code base as there are in general no guarantees
about the interoperability of TF 1 and TF 2 code.

In TF 2 datasets are Python iterables which means you can consume their
elements using `for elem in dataset: ...` or by explicitly creating iterator
via `iterator = iter(dataset)` and fetching its elements via
`values = next(iterator)`.

<br />

<br />

## Description

> [!NOTE]
> **Note:** The returned iterator will be in an uninitialized state, and you must run the `iterator.initializer` operation before using it:

    dataset = ...
    iterator = tf.compat.v1.data.make_initializable_iterator(dataset)
    # ...
    sess.run(iterator.initializer)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `dataset` | A [`tf.data.Dataset`](https://www.tensorflow.org/versions/r2.13/api_docs/python/tf/data/Dataset). |
| `shared_name` | (Optional.) If non-empty, the returned iterator will be shared under the given name across multiple sessions that share the same devices (e.g. when using a remote server). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A [`tf.data.Iterator`](https://www.tensorflow.org/versions/r2.13/api_docs/python/tf/data/Iterator) for elements of `dataset`. ||

<br />

<br />

<br />

<br />

| ## Raises ||
|---|---|
| `RuntimeError` | If eager execution is enabled. |

<br />