搭配 Azure Cosmos DB for Table 使用角色型存取控制（預覽）

發行項
12/18/2024
適用於:

✅ Table

部署指南順序中目前位置（『角色型存取控制』）的圖表。

本文逐步解說授與身分識別存取權，以管理 Azure Cosmos DB for Table 帳戶中的數據。本文中的步驟只涵蓋數據平面存取，以對個別專案執行作業並執行查詢。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
適用於數據表帳戶的現有 Azure Cosmos DB。
Microsoft Entra ID 中的一或多個現有身分識別。

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

準備角色定義

首先，您必須準備具有清單 dataActions 的角色定義，以授與 Azure Cosmos DB for Table 中讀取、查詢及管理數據的存取權。

內建定義
自訂定義

首先，使用 az cosmsodb show 取得現有 Azure Cosmos DB for Table 帳戶的資源識別碼，並將其儲存在變數中。然後，使用 az rest列出與您的 Azure Cosmos DB for Table 帳戶相關聯的所有角色定義。最後，檢閱輸出，並找出名為 Cosmos DB內建數據參與者的角色定義。輸出包含屬性中 id 角色定義的唯一標識碼。請記錄此值，因為本指南稍後必須在指派步驟中使用。

resourceId=$( \
    az cosmosdb show \
        --resource-group "<name-of-existing-resource-group>" \
        --name "<name-of-existing-table-account>" \
        --query "id" \
        --output tsv \
)

az rest \
    --method "GET" \
    --url $resourceId/tableRoleDefinitions?api-version=2023-04-15

[
  ...,
  {
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql/tableRoleDefinitions/00000000-0000-0000-0000-000000000002",
    "name": "00000000-0000-0000-0000-000000000002",
    "properties": {
      "assignableScopes": [
        "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql"
      ],
      "permissions": [
        {
          "dataActions": [
            "Microsoft.DocumentDB/databaseAccounts/readMetadata",
            "Microsoft.DocumentDB/databaseAccounts/tables/*",
            "Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/*"
          ],
          "notDataActions": []
        }
      ],
      "roleName": "Cosmos DB Built-in Data Contributor",
      "type": "BuiltInRole"
    },
    "type": "Microsoft.DocumentDB/databaseAccounts/tableRoleDefinitions"
  }
  ...
]

注意

在此範例中，id 值會是 /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql/tableRoleDefinitions/00000000-0000-0000-0000-000000000002。此範例會使用虛構的數據，而且您的標識符會與這個範例不同。此範例輸出已截斷。

用來 Get-AzCosmosDBAccount 取得現有 Azure Cosmos DB for Table 帳戶的資源識別碼，並將其儲存在變數中。然後，使用 Invoke-AzRestMethod 列出與 Azure Cosmos DB for Table 帳戶相關聯的所有角色定義。檢閱輸出，並找出名為 Cosmos DB內建數據參與者的角色定義。輸出包含屬性中 Id 角色定義的唯一標識碼。請記錄此值，因為本指南稍後必須在指派步驟中使用。

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-table-account>"
}
$resourceId = (
    Get-AzCosmosDBAccount @parameters |
        Select-Object -Property Id -First 1
).Id

$parameters = @{
  Path = "$resourceId/tableRoleDefinitions?api-version=2023-04-15"
  Method = "GET"
}
Invoke-AzRestMethod @parameters

StatusCode : 200
Content    : {
               "value": [
                ...,
                {
                  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql/tableRoleDefinitions/00000000-0000-0000-0000-000000000002",
                  "name": "00000000-0000-0000-0000-000000000002",
                  "properties": {
                    "assignableScopes": [
                      "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql"
                    ],
                    "permissions": [
                      {
                        "dataActions": [
                          "Microsoft.DocumentDB/databaseAccounts/readMetadata",
                          "Microsoft.DocumentDB/databaseAccounts/tables/*",
                          "Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/*"
                        ],
                        "notDataActions": []
                      }
                    ],
                    "roleName": "Cosmos DB Built-in Data Contributor",
                    "type": "BuiltInRole"
                  },
                  "type": "Microsoft.DocumentDB/databaseAccounts/tableRoleDefinitions"
                }
                ...
               ]
             }
...

注意

在此範例中，Id 值會是 /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql/tableRoleDefinitions/00000000-0000-0000-0000-000000000002。此範例會使用虛構的數據，而且您的標識符會與這個範例不同。此範例輸出已截斷。

建立名為 role-definition.json 的新 JSON 檔案。在此檔案中，建立資源定義，指定此處所列的數據動作：

	描述
`Microsoft.DocumentDB/databaseAccounts/readMetadata`	可以讀取帳戶層級元數據
*`Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/`**	可以執行任何容器層級的數據作業
*`Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/`**	可以使用容器對專案執行任何作業

{
  "properties": {
    "roleName": "Azure Cosmos DB for Table Data Plane Owner",
    "type": "CustomRole",
    "assignableScopes": [
      "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sidandrews-rbac/providers/Microsoft.DocumentDB/databaseAccounts/sidandrews-rbac-table/"
    ],
    "permissions": [
      {
        "dataActions": [
          "Microsoft.DocumentDB/databaseAccounts/readMetadata",
          "Microsoft.DocumentDB/databaseAccounts/tables/*",
          "Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/*"
        ]
      }
    ]
  }
}

現在，使用 az cosmosdb show 和 az rest 一起建立或更新角色定義，以發出 HTTP PUT 要求。在此要求中，請為您的角色定義指定唯一的 GUID。

resourceId=$( \
    az cosmosdb show \
        --resource-group "<name-of-existing-resource-group>" \
        --name "<name-of-existing-table-account>" \
        --query "id" \
        --output tsv \
)

az rest \
    --method "PUT" \
    --url $resourceId/tableRoleDefinitions/d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4?api-version=2023-04-15 \
    --body @role-definition.json

注意

在這裡範例中，指定的唯一 GUID 是 d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4。您可以為自己的角色定義指定任何唯一的 GUID。

輸出現在應該會指出要求已排入佇列。現在，等待加入佇列的角色定義部署完成。此工作可能需要幾分鐘的時間。
```
{
  "status": "Enqueued"
}
```

最後，再次檢查角色定義 az rest 清單。

resourceId=$( \
    az cosmosdb show \
        --resource-group "<name-of-existing-resource-group>" \
        --name "<name-of-existing-table-account>" \
        --query "id" \
        --output tsv \
)

az rest \
    --method "GET" \
    --url $resourceId/tableRoleDefinitions?api-version=2023-04-15

建立新的 Bicep 檔案來定義您的角色定義。將檔案 命名為 data-plane-role-definition.bicep。將這些內容 dataActions 新增至定義：

	描述
`Microsoft.DocumentDB/databaseAccounts/readMetadata`
*`Microsoft.DocumentDB/databaseAccounts/tables/`**
*`Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/`**

metadata description = 'Create RBAC definition for data plane access to Azure Cosmos DB for Table.'

@description('Name of the Azure Cosmos DB for Table account.')
param accountName string

@description('Name of the role definition.')
param roleDefinitionName string = 'API for Table Data Plane Owner'

resource account 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' existing = {
  name: accountName
}

resource definition 'Microsoft.DocumentDB/databaseAccounts/tableRoleDefinitions@2023-04-15' = {
  name: guid('table-role-definition', account.id)
  parent: account
  properties: {
    roleName: roleDefinitionName
    type: 'CustomRole'
    assignableScopes: [
      account.id
    ]
    permissions: [
      {
        dataActions: [
          'Microsoft.DocumentDB/databaseAccounts/readMetadata'
          'Microsoft.DocumentDB/databaseAccounts/tables/*'
          'Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/*'
        ]
      }
    ]
  }
}

output definitionId string = definition.id

建立名為 data-plane-role-definition.bicepparam的新 Bicep 參數檔案。在此參數檔案中，將現有 Azure Cosmos DB for Table 帳戶的名稱指派給 accountName 參數。
```
using './data-plane-role-definition.bicep'

param accountName = '<name-of-existing-table-account>'
```

使用 az deployment group create 部署 Bicep 範本。指定 Bicep 範本、參數檔案和 Azure 資源群組的名稱。

az deployment group create \
    --resource-group "<name-of-existing-resource-group>" \
    --parameters data-plane-role-definition.bicepparam \
    --template-file data-plane-role-definition.bicep

檢閱部署的輸出。輸出包含屬性中 properties.outputs.definitionId.value 角色定義的唯一標識碼。請記錄此值，因為本指南稍後必須在指派步驟中使用。
```
{
  "properties": {
    "outputs": {
      "definitionId": {
        "type": "String",
        "value": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-table-account/tableRoleDefinitions/dddddddd-9999-0000-1111-eeeeeeeeeeee"
      }
    }
  }
}
```
注意

在此範例中，id 值會是 /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-table-account/tableRoleDefinitions/dddddddd-9999-0000-1111-eeeeeeeeeeee。此範例會使用虛構的數據，而且您的標識符會與這個範例不同。這是從部署輸出的一般 JSON 子集，為了清楚起見。

使用 Get-AzCosmosDBAccount 和 Invoke-AzRestMethod 一起建立或更新您的角色定義，以發出 HTTP PUT 要求。此外，在此要求中，請為您的角色定義指定唯一的 GUID。最後，建立資源定義承載，以指定此處所列的數據動作：

	描述
`Microsoft.DocumentDB/databaseAccounts/readMetadata`	可以讀取帳戶層級元數據
*`Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/`**	可以執行任何容器層級的數據作業
*`Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers/items/`**	可以使用容器對專案執行任何作業

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-table-account>"
}
$resourceId = (
    Get-AzCosmosDBAccount @parameters |
        Select-Object -Property Id -First 1
).Id

$payload = @{
  properties = @{
    roleName = "Azure Cosmos DB for Table Data Plane Owner"
    type = "CustomRole"
    assignableScopes = @(
      "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sidandrews-rbac/providers/Microsoft.DocumentDB/databaseAccounts/sidandrews-rbac-table/"
    )
    permissions = @(
      @{
        dataActions = @(
          "Microsoft.DocumentDB/databaseAccounts/readMetadata",
          "Microsoft.DocumentDB/databaseAccounts/tables/*",
          "Microsoft.DocumentDB/databaseAccounts/tables/containers/entities/*"
        )
      }
    )
  }
}

$parameters = @{
  Path = "$resourceId/tableRoleDefinitions/d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4?api-version=2023-04-15"
  Method = "PUT"
  Payload = $payload | ConvertTo-Json -Depth 4
}
Invoke-AzRestMethod @parameters

注意

在這裡範例中，指定的唯一 GUID 是 d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4。您可以為自己的角色定義指定任何唯一的 GUID。

輸出應該會傳回狀態代碼為 200。現在，等待加入佇列的角色定義部署完成。此工作可能需要幾分鐘的時間。
```
StatusCode : 200
...
```

最後，再次檢查角色定義 Invoke-AzRestMethod 清單。

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-table-account>"
}
$resourceId = (
    Get-AzCosmosDBAccount @parameters |
        Select-Object -Property Id -First 1
).Id

$parameters = @{
  Path = "$resourceId/tableRoleDefinitions?api-version=2023-04-15"
  Method = "GET"
}
Invoke-AzRestMethod @parameters

將角色指派給身分識別

現在，將新定義的角色指派給身分識別，讓您的應用程式可以存取 Azure Cosmos DB for Table 中的數據。

重要

此指派工作會要求您擁有任何想要授與角色型訪問控制許可權之身分識別的唯一標識符。如果您沒有身分識別的唯一標識符，請遵循建立受控識別或取得登入身分識別指南中的指示。

使用 az cosmosdb show 取得您目前帳戶的唯一標識碼。

az cosmosdb show \
    --resource-group "<name-of-existing-resource-group>" \
    --name "<name-of-existing-resource-group>" \
    --query "{id:id}"

觀察上一個命令的輸出。記錄此帳戶的 id 屬性值，因為下一個步驟需要使用。
```
{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql"
}
```
注意

在此範例中，id 值會是 /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql。此範例會使用虛構的數據，而且您的標識符會與這個範例不同。
建立名為 role-assignment.json 的新 JSON 檔案。在 JSON 檔案中，新增您身分識別的唯一標識碼和帳戶資源的唯一標識碼。
```
{
  "properties": {
    "roleDefinitionId": "<account-resource-id>/tableRoleDefinitions/d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4",
    "scope": "<account-resource-id>",
    "principalId": "<id-of-existing-identity>"
  }
}
```
注意

在這裡範例中，指定的唯一 GUID 是 d3d3d3d3-eeee-ffff-aaaa-b4b4b4b4b4b4。您可以使用您先前用於自己角色定義的唯一 GUID。

現在，使用 az cosmosdb show 和 az rest 一起建立或更新角色指派，以發出 HTTP PUT 要求。在此要求中，請為角色指派指定唯一的 GUID。

resourceId=$( \
    az cosmosdb show \
        --resource-group "<name-of-existing-resource-group>" \
        --name "<name-of-existing-table-account>" \
        --query "id" \
        --output tsv \
)

az rest \
    --method "PUT" \
    --url $resourceId/tableRoleAssignments/e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5?api-version=2023-04-15 \
    --body @role-assignment.json

注意

在這裡範例中，指定的唯一 GUID 是 e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5。您可以為自己的角色指派指定任何唯一的 GUID。

建立另一個 Bicep 檔案，將角色指派給身分識別。將此檔案 命名為 data-plane-role-assignment.bicep。

metadata description = 'Assign RBAC role for data plane access to Azure Cosmos DB for Table.'

@description('Name of the Azure Cosmos DB for Table account.')
param accountName string

@description('Id of the role definition to assign to the targeted principal in the context of the account.')
param roleDefinitionId string

@description('Id of the identity/principal to assign this role in the context of the account.')
param identityId string

resource account 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' existing = {
  name: accountName
}

resource assignment 'Microsoft.DocumentDB/databaseAccounts/tableRoleAssignments@2023-04-15' = {
  name: guid(roleDefinitionId, identityId, account.id)
  parent: account
  properties: {
    principalId: identityId
    roleDefinitionId: roleDefinitionId
    scope: account.id
  }
}

output id string = assignment.id

建立名為 data-plane-role-assignment.bicepparam的新 Bicep 參數檔案。在此參數檔案中;將現有 Azure Cosmos DB for Table 帳戶的名稱指派給 accountName 參數、先前記錄的角色定義標識碼給 roleDefinitionId 參數，並將您身分識別的唯一標識符指派給 identityId 參數。
```
using './data-plane-role-assignment.bicep'

param accountName = '<name-of-existing-table-account>'
param roleDefinitionId = '<id-of-new-role-definition>'
param identityId = '<id-of-existing-identity>'
```

使用 az deployment group create部署此 Bicep 範本。

az deployment group create \
    --resource-group "<name-of-existing-resource-group>" \
    --parameters data-plane-role-assignment.bicepparam \
    --template-file data-plane-role-assignment.bicep

重複這些步驟，從您想要使用的任何其他身分識別授與帳戶的存取權。

提示

您可以針對您想要的身分識別重複這些步驟。一般而言，這些步驟至少會重複執行，以允許開發人員使用其人為身分識別存取帳戶，並允許應用程式使用受控識別進行存取。

使用『Get-AzCosmosDBAccount 來取得您目前帳戶的唯一標識符。

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-nosql-account>"
}
Get-AzCosmosDBAccount @parameters | Select -Property Id

觀察上一個命令的輸出。記錄此帳戶的 Id 屬性值，因為下一個步驟需要使用。
```
Id
--    
/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql
```
注意

在此範例中，Id 值會是 /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-identity-example/providers/Microsoft.DocumentDB/databaseAccounts/msdocs-identity-example-nosql。此範例會使用虛構的數據，而且您的標識符會與這個範例不同。

現在，使用 Get-AzCosmosDBAccount 和 Invoke-AzRestMethod 一起建立或更新角色指派，以發出 HTTP PUT 要求。在此要求中，請為角色指派指定唯一的 GUID。最後，建立資源指派承載，指定您身分識別的唯一標識符。

$parameters = @{
    ResourceGroupName = "<name-of-existing-resource-group>"
    Name = "<name-of-existing-table-account>"
}
$resourceId = (
    Get-AzCosmosDBAccount @parameters |
        Select-Object -Property Id -First 1
).Id    

$payload = @{
  properties = @{
    roleDefinitionId = "$resourceId/tableRoleDefinitions/00000000-0000-0000-0000-000000000002"
    scope = "$resourceId"
    principalId = "<id-of-existing-identity>"
  }
}

$parameters = @{
  Path = "$resourceId/tableRoleAssignments/e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5?api-version=2023-04-15"
  Method = "PUT"
  Payload = $payload | ConvertTo-Json -Depth 2
}
Invoke-AzRestMethod @parameters

注意

在這裡範例中，指定的唯一 GUID 是 e4e4e4e4-ffff-aaaa-bbbb-c5c5c5c5c5c5。您可以為自己的角色指派指定任何唯一的 GUID。

驗證程式代碼中的數據平面存取

最後，使用您慣用的程式設計語言使用應用程式程式代碼和 Azure SDK，驗證您是否已正確授與存取權。

using Azure.Identity;
using Azure.Data.Tables;

string endpoint = "<account-endpoint>";

DefaultAzureCredential credential = new();

TableServiceClient client = new(
    endpoint: new Uri(endpoint),
    tokenCredential: credential
);

TableClient table = client.GetTableClient(
    tableName: "<name-of-table>"
);

重要

此程式代碼範例會使用 NuGet 中的 Azure.Data.Tables 和 Azure.Identity 連結庫。

const { TableServiceClient, TableClient } = require('@azure/data-tables');
const { DefaultAzureCredential } = require('@azure/identity');

const endpoint = '<account-endpoint>';

let credential = new DefaultAzureCredential();

let client = new TableServiceClient(endpoint, credential);

let table = new TableClient(endpoint, "<table-name>", credential);

重要

此程式代碼範例會使用來自 npm 的 @azure/data-tables 和 @azure/identity 套件。

import { TableServiceClient, TableClient } from '@azure/data-tables';
import { TokenCredential, DefaultAzureCredential } from '@azure/identity';

const endpoint: string = '<account-endpoint>';

let credential: TokenCredential = new DefaultAzureCredential();

let client: TableServiceClient = new TableServiceClient(endpoint, credential);

let table: TableClient = new TableClient(endpoint, "<table-name>", credential);

重要

此程式代碼範例會使用來自 npm 的 @azure/data-tables 和 @azure/identity 套件。

from azure.data.tables import TableServiceClient, TableClient
from azure.identity import DefaultAzureCredential

endpoint = "<account-endpoint>"

credential = DefaultAzureCredential()

client = TableServiceClient(endpoint, credential=credential)

table = client.get_table_client("<table-name>")

重要

此程式代碼範例會使用 PyPI 中的 azure-data-tables 和 azure-identity 套件。

package main

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
    "github.com/Azure/azure-sdk-for-go/sdk/data/aztables"
)

const endpoint = "<account-endpoint>"

func main() {
    credential, _ := azidentity.NewDefaultAzureCredential(nil)
    client, _ := aztables.NewServiceClient(endpoint, credential, nil)
    table, _ := client.NewClient("<table-name>")
}

重要

此程式代碼範例會使用 Go 中的 azure/azure-sdk-for-go/sdk/data/aztables 和 azure/azure-sdk-for-go/sdk/azidentity 套件。

import com.azure.data.tables.TableClient;
import com.azure.data.tables.TableServiceClient;
import com.azure.data.tables.TableServiceClientBuilder;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;

public class Table{
    public static void main(String[] args){
        DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
            .build();
        
        TableServiceClient client = new TableServiceClientBuilder()
            .endpoint("<nosql-endpoint>")
            .credential(credential)
            .buildClient();

        TableClient table = client
            .getTableClient("<table-name>");
    }
}

重要

此程式代碼範例會使用 Maven 中的 com.azure/azure-data-tables 和 com.azure/azure-identity 套件。

警告

如果您使用使用者指派的受控識別，您必須在建立認證物件時指定受控識別的唯一標識符。

共用方式為

搭配 Azure Cosmos DB for Table 使用角色型存取控制（預覽）

必要條件

準備角色定義

將角色指派給身分識別

驗證程式代碼中的數據平面存取

意見反應

其他資源

共用方式為

搭配 Azure Cosmos DB for Table 使用角色型存取控制 （預覽）

必要條件

準備角色定義

將角色指派給身分識別

驗證程式代碼中的數據平面存取

意見反應

其他資源

搭配 Azure Cosmos DB for Table 使用角色型存取控制（預覽）