文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# `RestoreTable` 搭配 AWS SDK 使用
下列程式碼範例示範如何使用 `RestoreTable`。
動作範例是大型程式的程式碼摘錄，必須在內容中執行。您可以在下列程式碼範例的內容中看到此動作：
+ [了解基本概念](keyspaces_example_keyspaces_Scenario_GetStartedKeyspaces_section.md)
------
#### [ .NET ]
**適用於 .NET 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Keyspaces#code-examples)中設定和執行。
```
///
/// Restores the specified table to the specified point in time.
///
/// The keyspace containing the table.
/// The name of the table to restore.
/// The time to which the table will be restored.
/// The Amazon Resource Name (ARN) of the restored table.
public async Task RestoreTable(string keyspaceName, string tableName, string restoredTableName, DateTime timestamp)
{
var request = new RestoreTableRequest
{
RestoreTimestamp = timestamp,
SourceKeyspaceName = keyspaceName,
SourceTableName = tableName,
TargetKeyspaceName = keyspaceName,
TargetTableName = restoredTableName
};
var response = await _amazonKeyspaces.RestoreTableAsync(request);
return response.RestoredTableARN;
}
```
+ 如需 API 詳細資訊，請參閱《適用於 .NET 的 AWS SDK API 參考》**中的 [RestoreTable](https://docs.aws.amazon.com/goto/DotNetSDKV3/keyspaces-2022-02-10/RestoreTable)。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/keyspaces#code-examples)中設定和執行。
```
public static void restoreTable(KeyspacesClient keyClient, String keyspaceName, ZonedDateTime utc) {
try {
Instant myTime = utc.toInstant();
RestoreTableRequest restoreTableRequest = RestoreTableRequest.builder()
.restoreTimestamp(myTime)
.sourceTableName("Movie")
.targetKeyspaceName(keyspaceName)
.targetTableName("MovieRestore")
.sourceKeyspaceName(keyspaceName)
.build();
RestoreTableResponse response = keyClient.restoreTable(restoreTableRequest);
System.out.println("The ARN of the restored table is " + response.restoredTableARN());
} catch (KeyspacesException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [RestoreTable](https://docs.aws.amazon.com/goto/SdkForJavaV2/keyspaces-2022-02-10/RestoreTable)。
------
#### [ Kotlin ]
**適用於 Kotlin 的 SDK**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/keyspaces#code-examples)中設定和執行。
```
suspend fun restoreTable(
keyspaceName: String?,
utc: ZonedDateTime,
) {
// Create an aws.smithy.kotlin.runtime.time.Instant value.
val timeStamp =
aws.smithy.kotlin.runtime.time
.Instant(utc.toInstant())
val restoreTableRequest =
RestoreTableRequest {
restoreTimestamp = timeStamp
sourceTableName = "MovieKotlin"
targetKeyspaceName = keyspaceName
targetTableName = "MovieRestore"
sourceKeyspaceName = keyspaceName
}
KeyspacesClient.fromEnvironment { region = "us-east-1" }.use { keyClient ->
val response = keyClient.restoreTable(restoreTableRequest)
println("The ARN of the restored table is ${response.restoredTableArn}")
}
}
```
+ 如需 API 詳細資訊，請參閱《適用於 Kotlin 的AWS SDK API 參考》**中的 [RestoreTable](https://sdk.amazonaws.com/kotlin/api/latest/index.html)。
------
#### [ Python ]
**適用於 Python 的 SDK (Boto3)**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/keyspaces#code-examples)中設定和執行。
```
class KeyspaceWrapper:
"""Encapsulates Amazon Keyspaces (for Apache Cassandra) keyspace and table actions."""
def __init__(self, keyspaces_client):
"""
:param keyspaces_client: A Boto3 Amazon Keyspaces client.
"""
self.keyspaces_client = keyspaces_client
self.ks_name = None
self.ks_arn = None
self.table_name = None
@classmethod
def from_client(cls):
keyspaces_client = boto3.client("keyspaces")
return cls(keyspaces_client)
def restore_table(self, restore_timestamp):
"""
Restores the table to a previous point in time. The table is restored
to a new table in the same keyspace.
:param restore_timestamp: The point in time to restore the table. This time
must be in UTC format.
:return: The name of the restored table.
"""
try:
restored_table_name = f"{self.table_name}_restored"
self.keyspaces_client.restore_table(
sourceKeyspaceName=self.ks_name,
sourceTableName=self.table_name,
targetKeyspaceName=self.ks_name,
targetTableName=restored_table_name,
restoreTimestamp=restore_timestamp,
)
except ClientError as err:
logger.error(
"Couldn't restore table %s. Here's why: %s: %s",
restore_timestamp,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
else:
return restored_table_name
```
+ 如需 API 詳細資訊，請參閱《AWS SDK for Python (Boto3) API 參考》**中的 [RestoreTable](https://docs.aws.amazon.com/goto/boto3/keyspaces-2022-02-10/RestoreTable)。
------
#### [ SAP ABAP ]
**適用於 SAP ABAP 的開發套件**
GitHub 上提供更多範例。尋找完整範例，並了解如何在 [AWS 程式碼範例儲存庫](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/kys#code-examples)中設定和執行。
```
TRY.
oo_result = lo_kys->restoretable(
iv_sourcekeyspacename = iv_source_keyspace_name
iv_sourcetablename = iv_source_table_name
iv_targetkeyspacename = iv_target_keyspace_name
iv_targettablename = iv_target_table_name
iv_restoretimestamp = iv_restore_timestamp ).
MESSAGE 'Table restore initiated successfully.' TYPE 'I'.
CATCH /aws1/cx_rt_service_generic INTO DATA(lo_exception).
DATA(lv_error) = |"{ lo_exception->av_err_code }" - { lo_exception->av_err_msg }|.
MESSAGE lv_error TYPE 'E'.
ENDTRY.
```
+ 如需 API 詳細資訊，請參閱《適用於 *AWS SAP ABAP 的 SDK API 參考*》中的 [RestoreTable](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。
------