Azure Data Tables Java

作者 microsoft354361d83247MIT收錄於 2026年10月8日更新於 2026年10月8日

Build table storage applications with Azure Tables SDK for Java. Use when working with Azure Table Storage or Cosmos DB Table API for NoSQL key-value data, schemaless storage, or structured data at scale.

精選僅含說明Software Development
AI 產生的概覽

指導 Java 開發者使用 Azure Tables SDK 建置 Azure 資料表儲存體與 Cosmos DB 資料表 API 應用程式。

功能
此技能提供使用 Azure Tables SDK for Java 的參考指示與程式碼範例。內容涵蓋透過連接字串、共用金鑰、SAS 權杖與 DefaultAzureCredential 建立用戶端，以及資料表與實體的 CRUD、OData 篩選、批次交易、具型別實體與錯誤處理。它產出的是指引與範例程式碼，而非可執行指令碼。
適用情境
適用於撰寫將無結構描述鍵值或結構化資料儲存至 Azure 資料表儲存體或 Cosmos DB 資料表 API 的 Java 應用程式。適合涉及分割區索引鍵與資料列索引鍵、資料表實體操作，或使用 OData 篩選條件查詢資料表的任務。
執行需求
需要 com.azure:azure-data-tables Java 套件，以及 Azure 儲存體或 Cosmos DB 資料表 API 帳戶。需要連接字串、帳戶金鑰、SAS 權杖或 Entra ID 身分等認證，並需要連線至服務端點的網路存取。不包含指令碼。

Azure Tables SDK for Java

Build table storage applications using the Azure Tables SDK for Java. Works with both Azure Table Storage and Cosmos DB Table API.

Installation

xml
<dependency>  <groupId>com.azure</groupId>  <artifactId>azure-data-tables</artifactId>  <version>12.6.0-beta.1</version></dependency>

Client Creation

With Connection String

java
import com.azure.data.tables.TableServiceClient;import com.azure.data.tables.TableServiceClientBuilder;import com.azure.data.tables.TableClient;
TableServiceClient serviceClient = new TableServiceClientBuilder()    .connectionString("<your-connection-string>")    .buildClient();

With Shared Key

java
import com.azure.core.credential.AzureNamedKeyCredential;
AzureNamedKeyCredential credential = new AzureNamedKeyCredential(    "<account-name>",    "<account-key>");
TableServiceClient serviceClient = new TableServiceClientBuilder()    .endpoint("<your-table-account-url>")    .credential(credential)    .buildClient();

With SAS Token

java
TableServiceClient serviceClient = new TableServiceClientBuilder()    .endpoint("<your-table-account-url>")    .sasToken("<sas-token>")    .buildClient();

With DefaultAzureCredential (Storage only)

java
import com.azure.core.credential.TokenCredential;import com.azure.identity.AzureIdentityEnvVars;import com.azure.identity.DefaultAzureCredentialBuilder;import com.azure.identity.ManagedIdentityCredentialBuilder;
// Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>TokenCredential credential = new DefaultAzureCredentialBuilder()    .requireEnvVars(AzureIdentityEnvVars.AZURE_TOKEN_CREDENTIALS)    .build();// Or use a specific credential directly in production:// See https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes// TokenCredential credential = new ManagedIdentityCredentialBuilder().build();
TableServiceClient serviceClient = new TableServiceClientBuilder()    .endpoint("<your-table-account-url>")    .credential(credential)    .buildClient();

Key Concepts

  • TableServiceClient: Manage tables (create, list, delete)
  • TableClient: Manage entities within a table (CRUD)
  • Partition Key: Groups entities for efficient queries
  • Row Key: Unique identifier within a partition
  • Entity: A row with up to 252 properties (1MB Storage, 2MB Cosmos)

Core Patterns

Create Table

java
// Create table (throws if exists)TableClient tableClient = serviceClient.createTable("mytable");
// Create if not exists (no exception)TableClient tableClient = serviceClient.createTableIfNotExists("mytable");

Get Table Client

java
// From service clientTableClient tableClient = serviceClient.getTableClient("mytable");
// Direct constructionTableClient tableClient = new TableClientBuilder()    .connectionString("<connection-string>")    .tableName("mytable")    .buildClient();

Create Entity

java
import com.azure.data.tables.models.TableEntity;
TableEntity entity = new TableEntity("partitionKey", "rowKey")    .addProperty("Name", "Product A")    .addProperty("Price", 29.99)    .addProperty("Quantity", 100)    .addProperty("IsAvailable", true);
tableClient.createEntity(entity);

Get Entity

java
TableEntity entity = tableClient.getEntity("partitionKey", "rowKey");
String name = (String) entity.getProperty("Name");Double price = (Double) entity.getProperty("Price");System.out.printf("Product: %s, Price: %.2f%n", name, price);

Update Entity

java
import com.azure.data.tables.models.TableEntityUpdateMode;
// Merge (update only specified properties)TableEntity updateEntity = new TableEntity("partitionKey", "rowKey")    .addProperty("Price", 24.99);tableClient.updateEntity(updateEntity, TableEntityUpdateMode.MERGE);
// Replace (replace entire entity)TableEntity replaceEntity = new TableEntity("partitionKey", "rowKey")    .addProperty("Name", "Product A Updated")    .addProperty("Price", 24.99)    .addProperty("Quantity", 150);tableClient.updateEntity(replaceEntity, TableEntityUpdateMode.REPLACE);

Upsert Entity

java
// Insert or update (merge mode)tableClient.upsertEntity(entity, TableEntityUpdateMode.MERGE);
// Insert or replacetableClient.upsertEntity(entity, TableEntityUpdateMode.REPLACE);

Delete Entity

java
tableClient.deleteEntity("partitionKey", "rowKey");

List Entities

java
import com.azure.data.tables.models.ListEntitiesOptions;
// List all entitiesfor (TableEntity entity : tableClient.listEntities()) {    System.out.printf("%s - %s%n",        entity.getPartitionKey(),        entity.getRowKey());}
// With filtering and selectionListEntitiesOptions options = new ListEntitiesOptions()    .setFilter("PartitionKey eq 'sales'")    .setSelect("Name", "Price");
for (TableEntity entity : tableClient.listEntities(options, null, null)) {    System.out.printf("%s: %.2f%n",        entity.getProperty("Name"),        entity.getProperty("Price"));}

Query with OData Filter

java
// Filter by partition keyListEntitiesOptions options = new ListEntitiesOptions()    .setFilter("PartitionKey eq 'electronics'");
// Filter with multiple conditionsoptions.setFilter("PartitionKey eq 'electronics' and Price gt 100");
// Filter with comparison operatorsoptions.setFilter("Quantity ge 10 and Quantity le 100");
// Top N resultsoptions.setTop(10);
for (TableEntity entity : tableClient.listEntities(options, null, null)) {    System.out.println(entity.getRowKey());}

Batch Operations (Transactions)

java
import com.azure.data.tables.models.TableTransactionAction;import com.azure.data.tables.models.TableTransactionActionType;import java.util.Arrays;
// All entities must have same partition keyList<TableTransactionAction> actions = Arrays.asList(    new TableTransactionAction(        TableTransactionActionType.CREATE,        new TableEntity("batch", "row1").addProperty("Name", "Item 1")),    new TableTransactionAction(        TableTransactionActionType.CREATE,        new TableEntity("batch", "row2").addProperty("Name", "Item 2")),    new TableTransactionAction(        TableTransactionActionType.UPSERT_MERGE,        new TableEntity("batch", "row3").addProperty("Name", "Item 3")));
tableClient.submitTransaction(actions);

List Tables

java
import com.azure.data.tables.models.TableItem;import com.azure.data.tables.models.ListTablesOptions;
// List all tablesfor (TableItem table : serviceClient.listTables()) {    System.out.println(table.getName());}
// Filter tablesListTablesOptions options = new ListTablesOptions()    .setFilter("TableName eq 'mytable'");
for (TableItem table : serviceClient.listTables(options, null, null)) {    System.out.println(table.getName());}

Delete Table

java
serviceClient.deleteTable("mytable");

Typed Entities

java
public class Product implements TableEntity {    private String partitionKey;    private String rowKey;    private OffsetDateTime timestamp;    private String eTag;    private String name;    private double price;        // Getters and setters for all fields    @Override    public String getPartitionKey() { return partitionKey; }    @Override    public void setPartitionKey(String partitionKey) { this.partitionKey = partitionKey; }    @Override    public String getRowKey() { return rowKey; }    @Override    public void setRowKey(String rowKey) { this.rowKey = rowKey; }    // ... other getters/setters        public String getName() { return name; }    public void setName(String name) { this.name = name; }    public double getPrice() { return price; }    public void setPrice(double price) { this.price = price; }}
// UsageProduct product = new Product();product.setPartitionKey("electronics");product.setRowKey("laptop-001");product.setName("Laptop");product.setPrice(999.99);
tableClient.createEntity(product);

Error Handling

java
import com.azure.data.tables.models.TableServiceException;
try {    tableClient.createEntity(entity);} catch (TableServiceException e) {    System.out.println("Status: " + e.getResponse().getStatusCode());    System.out.println("Error: " + e.getMessage());    // 409 = Conflict (entity exists)    // 404 = Not Found}

Environment Variables

bash
# Storage AccountAZURE_TABLES_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...  # Alternative to Entra ID authAZURE_TABLES_ENDPOINT=https://<account>.table.core.windows.net  # Required for all auth methodsAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production
# Cosmos DB Table APICOSMOS_TABLE_ENDPOINT=https://<account>.table.cosmosdb.azure.com  # Alternative endpoint for Cosmos DB Table API

Best Practices

  1. Partition Key Design: Choose keys that distribute load evenly
  2. Batch Operations: Use transactions for atomic multi-entity updates
  3. Query Optimization: Always filter by PartitionKey when possible
  4. Select Projection: Only select needed properties for performance
  5. Entity Size: Keep entities under 1MB (Storage) or 2MB (Cosmos)

Trigger Phrases

  • "Azure Tables Java"
  • "table storage SDK"
  • "Cosmos DB Table API"
  • "NoSQL key-value storage"
  • "partition key row key"
  • "table entity CRUD"

來源與署名

來源：microsoft/skills位於.github/plugins/azure-sdk-java/skills/azure-data-tables-java提交354361d

授權條款： MIT

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 microsoft/skills 的技能

Customize

microsoft

精選

以互動式引導流程部署 Azure OpenAI 模型，可自訂版本、SKU、容量與內容篩選。

DevOps & Cloud2026年10月8日

Discover Azure Skills

microsoft

精選

搜尋 GitHub 上的 Azure 技能目錄，並推薦符合 Azure 工作的可安裝代理技能。

AI & Agents2026年10月8日

Azure Resource Visualizer

microsoft

精選

分析 Azure 資源群組，並產出內含詳細 Mermaid 架構圖與資源關係說明的 Markdown 文件。

DevOps & Cloud2026年10月8日

Azure Resource Lookup

microsoft

精選

使用 Azure Resource Graph 查詢與 MCP 工具，跨訂閱列出和尋找 Azure 資源。

DevOps & Cloud2026年10月8日

Azure Messaging

microsoft

精選

疑難排解並解決 Azure 事件中樞與 Service Bus SDK 的連線、驗證和訊息處理問題。

DevOps & Cloud2026年10月8日

Azure Kusto

microsoft

精選

在 Azure Data Explorer（Kusto）中執行 KQL 查詢並探索結構描述，用於日誌、遙測與時間序列分析。

Data & Analytics2026年10月8日

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Testing Strategy

anthropics

精選

設計測試策略與測試計畫，涵蓋測試類型、覆蓋率目標與範例測試案例。

Software Development27K今天更新

Tech Debt

anthropics

精選

辨識、分類並排序技術債，產出評分後的待辦清單與分階段改善計畫。

Software Development27K今天更新

System Design

anthropics

精選

透過需求、高階設計、深入設計、擴充與取捨分析來指導系統與架構設計。

Software Development27K今天更新