# tf.raw_ops.AddSparseToTensorsMap

<br />

Add a `SparseTensor` to a `SparseTensorsMap` return its handle.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.raw_ops.AddSparseToTensorsMap`](https://www.tensorflow.org/api_docs/python/tf/raw_ops/AddSparseToTensorsMap)

<br />

    tf.raw_ops.AddSparseToTensorsMap(
        sparse_indices,
        sparse_values,
        sparse_shape,
        container='',
        shared_name='',
        name=None
    )

A `SparseTensor` is represented by three tensors: `sparse_indices`,
`sparse_values`, and `sparse_shape`.

This operator takes the given `SparseTensor` and adds it to a container
object (a `SparseTensorsMap`). A unique key within this container is generated
in the form of an `int64`, and this is the value that is returned.

The `SparseTensor` can then be read out as part of a minibatch by passing
the key as a vector element to `TakeManySparseFromTensorsMap`. To ensure
the correct `SparseTensorsMap` is accessed, ensure that the same
`container` and `shared_name` are passed to that Op. If no `shared_name`
is provided here, instead use the *name* of the Operation created by calling
`AddSparseToTensorsMap` as the `shared_name` passed to
`TakeManySparseFromTensorsMap`. Ensure the Operations are colocated.

<br />

<br />

<br />

| ## Args ||
|---|---|
| `sparse_indices` | A `Tensor` of type `int64`. 2-D. The `indices` of the `SparseTensor`. |
| `sparse_values` | A `Tensor`. 1-D. The `values` of the `SparseTensor`. |
| `sparse_shape` | A `Tensor` of type `int64`. 1-D. The `shape` of the `SparseTensor`. |
| `container` | An optional `string`. Defaults to `""`. The container name for the `SparseTensorsMap` created by this op. |
| `shared_name` | An optional `string`. Defaults to `""`. The shared name for the `SparseTensorsMap` created by this op. If blank, the new Operation's unique name is used. |
| `name` | A name for the operation (optional). |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A `Tensor` of type `int64`. ||

<br />