版本说明

本示例基于华为云SDK V3.0版本开发。

功能介绍

数据库实例是在云中运行的独立数据库环境，它是华为云关系型数据库服务的基本构建块。一个数据库实例可以包含多个由用户创建的数据库，并且可以使用与访问独立数据库实例相同的工具和应用程序进行访问。本示例为您介绍了数据库实例的创建、删除、查询以及规格变更、单一转主备等操作。

准备工作

• 1、华为云 Java SDK 支持两种认证方式：token认证和AK/SK认证。
• 2、华为云 Java SDK 支持 Java JDK 1.8 及其以上版本。

数据库实例的管理

初始化

参数获取可参照准备工作中华为云SDK认证方式。

                    
                    Copied!
                
// endpoint url
String authUrl = "****************";
String user = "****************";
String password = "****************";
String projectId = "****************";
String userDomainId = "****************";
Config config = Config.newConfig().withLanguage("zh-cn").withSSLVerificationDisabled();
OSClient.OSClientV3 osclient = OSFactory.builderV3().withConfig(config).endpoint(authUrl)
        .credentials(user, password, Identifier.byId(userDomainId))
        .scopeToProject(Identifier.byId(projectId)).authenticate();

InstanceManageService instanceManageService = osclient.rds().instanceManage();

创建数据库实例

创建所需部分参数

代码展示

                    
                    Copied!
                
public static void CreatInstanceTest(InstanceManageService instanceManageService) {
    DataStore datastore = DataStore.builder().type("MySQL").version("5.6").build();
    Ha createha = Ha.builder().mode("Ha").replicationMode("semisync").build();
    Volume createVolume = Volume.builder().type("ULTRAHIGH").size(100).build();
    BackupStrategy createBackupStrategy = BackupStrategy.builder().keepDays(7)
            .startTime("06:15-07:15").build();

    CreateInstanceRequest CreateReq = CreateInstanceRequest.builder()
            .name("JAVA100_2_S-2").volume(createVolume)
            .ha(createha).datastore(datastore).backupStrategy(createBackupStrategy)
            .flavorRef("rds.mysql.s1.medium.ha")
            .availabilityZone("cn-north-4b,cn-north-4b")
            .vpcId("3138ce3d-8837-****-b68a-4cdbc5b30a45")
            .subnetId("0f48e1d1-c244-****-baa0-acfb1133c148")
            .securityGroupId("702e9e18-34a2-****-a847-59546c3f5fa5")
            .password("******").port("3306")
            .region("cn-north-4").build();
    try {
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        CreateInstanceResponse repCreate = instanceManageService.create(CreateReq);
        System.out.println(repCreate.getInstance());
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：具体参数信息请参考API Explorer。

查询数据库实例

根据实例ID查询数据库实例

                    
                    Copied!
                
public static void ListInstanceTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        Map<String, String> filteringParams = new HashMap<String, String>();
        filteringParams.put("offset", "0");
        filteringParams.put("limit", "10");
        filteringParams.put("id", instanceId);
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        ListInstanceResponse ListInstances = instanceManageService.list(filteringParams);
        if (ListInstances != null) {
            System.out.println("server list: " + ListInstances);
            if (ListInstances.getInstances().size() > 0) {
                for (ListInstanceResp InstanceInfor : ListInstances.getInstances()) {
                    System.out.println("Instances number is : " + ListInstances.getInstances().size());
                    System.out.println("InstanceInfor.getName: " + InstanceInfor.getName());
                    System.out.println("InstanceInfor.getId: " + InstanceInfor.getId());
                }
            }
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：其他条件查询，如实例名称、实例类型等请参考API Explorer。

删除数据库实例

根据实例ID删除数据库实例

                    
                    Copied!
                
public static void DeleteInstanceTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        ActionResponse response = instanceManageService.delete(instanceId);
        if (response.getCode() != 0) {
            System.out.println(response.getCode());
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：

• 1、删除数据库实例，不支持删除包周期实例。对于包年包月的主实例和只读实例，您需要进行订单退订才可删除实例，详细操作请参见退订包周期实例。
• 2、更多信息请参考API Explorer。

重启数据库实例

                    
                    Copied!
                
public static void RestartInstanceTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        RestartInstanceRequest restart = RestartInstanceRequest.builder().restart("").build();
        InstanceCommonResponse rep = instanceManageService.restart(restart, instanceId);
        if (rep.getJobId() != "") {
            System.out.println(rep.getJobId());
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：

• 1、具体参数说明请参考API Explorer。
• 2、实例在创建、扩容、变更规格、备份、恢复、修改端口或冻结状态下不能重启。
• 3、RDS实例重启过程中将不可用，请谨慎操作。

单机转主备实例

单机实例转主备实例

                    
                    Copied!
                
public static void SingletohaTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        SingleToHa single = SingleToHa.builder().azCodeNewNode("cn-north-4c").password("******").build();
        SingleToHaRdsRequest singletoha = SingleToHaRdsRequest.builder().singleToHa(single).build();
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        InstanceCommonResponse rep = instanceManageService.singleToHa(singletoha, instanceId);
        if (rep.getJobId() != "") {
            System.out.println(rep.getJobId());
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：

• 1、具体参数说明请参考API Explorer。
• 2、包周期实例不能转为主备实例。
• 3、有些实例规格不支持升级为主备实例，具体请以实际环境为准。

变更数据库实例的规格

变更数据库实例规格

                    
                    Copied!
                
public static void ResizeFlavorTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        ResizeFlavor resizeFlavor = ResizeFlavor.builder().specCode("rds.mysql.m1.4xlarge.ha").build();
        ResizeFlavorRequest resizeFlavorRequest = ResizeFlavorRequest.builder().resizeFlavor(resizeFlavor).build();
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        InstanceCommonResponse rep = instanceManageService.resizeFlavor(resizeFlavorRequest, instanceId);
        if (rep.getJobId() != "") {
            System.out.println(rep.getJobId());
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：

• 1、具体参数说明请参考API Explorer。
• 2、需要变更的数据库实例规格不能与原数据库实例规格一样。
• 3、实例状态仅为服务中时可以进行调整CPU/内存。
• 4、若属于包周期数据库实例，仅MySQL引擎支持变更规格。
• 5、只能变更相同类型数据库实例的规格。（例如，单实例只能变更为单实例对应的规格，不能变更为HA的规格）。
• 6、变更数据库实例规格时，RDS会有5~10分钟的业务中断重启，请谨慎操作。

扩容数据库实例的磁盘空间

扩容数据库实例的磁盘空间

                    
                    Copied!
                
public static void EnlargeVolumeTest(InstanceManageService instanceManageService, String instanceId) {
    try {
        EnlargeVolumeSize volumeSize = EnlargeVolumeSize.builder().size(200).build();
        EnlargeVolumeRequest enlargeVolumeRequest = EnlargeVolumeRequest.builder().enlargeVolume(volumeSize).build();
        if (instanceManageService == null) {
            System.out.println("[Error information]Get authenticate is null!");
            return;
        }
        InstanceCommonResponse rep = instanceManageService.enlargeVolume(enlargeVolumeRequest, instanceId);
        if (rep.getJobId() != "") {
            System.out.println(rep.getJobId());
        }
    } catch (ServerResponseException e) {
        System.out.println(e.getStatusCode());
    }
}

说明：

• 1、参数说明请参考API Explorer。
• 2、备实例大小和主实例大小一致，当主实例扩容时，会同时扩容备实例。
• 3、实例状态为“服务中”时可以进行扩容。
• 4、若属于包周期数据库实例，仅MySQL引擎支持扩容磁盘空间。

参考

更多信息请参考云数据库 RDS。