> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IWorkspaceDatasetsService

- Package: [@gooddata/sdk-backend-spi](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-backend-spi/src/workspace/ldm/datasets.ts

Service for querying workspace datasets

**Signature:**

```typescript
export interface IWorkspaceDatasetsService 
```

## Methods

| Method | Description |
| --- | --- |
| [getAllDatasetsMeta()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsservicegetalldatasetsmeta) | Receive all workspace datasets metadata |
| [getDataset(ref)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsservicegetdataset) | **_(BETA)_** Get dataset by reference. |
| [getDatasets()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsservicegetdatasets) | Receive all workspace csv datasets |
| [getDataSets(refs)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsservicegetdatasets) | Get all dataSets for given refs |
| [getDatasetsQuery()](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsservicegetdatasetsquery) | **_(BETA)_** Datasets query factory. |
| [updateDatasetMeta(dataSet)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.iworkspacedatasetsservice/index.md#iworkspacedatasetsserviceupdatedatasetmeta) | **_(BETA)_** Updates metadata object for the dataset. |

## Method details

### IWorkspaceDatasetsService.getAllDatasetsMeta()

Receive all workspace datasets metadata

**Signature:**

```typescript
getAllDatasetsMeta(): Promise<IMetadataObject[]>;
```
**Returns:**

Promise&lt;[IMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetadataobject/index.md)[]&gt;

promise of workspace datasets metadata

### IWorkspaceDatasetsService.getDataset()

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Get dataset by reference.

**Signature:**

```typescript
getDataset(ref: ObjRef): Promise<IDataSetMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| ref | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | ref of the dataset |

**Returns:**

Promise&lt;[IDataSetMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idatasetmetadataobject/index.md)&gt;

promise of dataset metadata object

### IWorkspaceDatasetsService.getDataSets()

Get all dataSets for given refs

**Signature:**

```typescript
getDataSets(refs: ObjRef[]): Promise<IDataSetMetadataObject[]>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| refs | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md)[] |  |

**Returns:**

Promise&lt;[IDataSetMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idatasetmetadataobject/index.md)[]&gt;

promise array of workspace dataSets metadata objects

### IWorkspaceDatasetsService.getDatasetsQuery()

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Datasets query factory.

**Signature:**

```typescript
getDatasetsQuery(): IDatasetsQuery;
```
**Returns:**

[IDatasetsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.idatasetsquery/index.md)

datasets query

### IWorkspaceDatasetsService.updateDatasetMeta()

> **Beta API.** Mostly stable, but details may change in a minor release, outside SemVer. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Updates metadata object for the dataset.

**Signature:**

```typescript
updateDatasetMeta(dataSet: Partial<IMetadataObjectBase> & IMetadataObjectIdentity): Promise<IDataSetMetadataObject>;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| dataSet | Partial&lt;[IMetadataObjectBase](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetadataobjectbase/index.md)&gt; &amp; [IMetadataObjectIdentity](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.imetadataobjectidentity/index.md) | dataset metadata object to update |

**Returns:**

Promise&lt;[IDataSetMetadataObject](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.idatasetmetadataobject/index.md)&gt;

promise of updated dataset metadata object