29、号外！号外！ERA5再分析数据下载方式更新啦

1. 前言

最近，更新ERA5月尺度再分析数据时，发现页面上出现了下面的提示：

系统提示，从2024年9月份开始，原有的ERA5下载方式将停止工作，2024年9月份以后，需要使用CDS-Beta方式进行ERA5数据的下载。下面，将详细介绍如何使用CDS-Beta下载ERA5再分析数据，以及使用过程中可能会遇到的问题。

2. 账号注册与协议签署

2.1 账号注册

注册链接：https://www.ecmwf.int/

点击右上角Log in进行注册，如果先前已经注册过账号，直接登录即可。


完成注册后，请登录账号。已有账号，请直接登录。

2.2 签署CDS-Beta使用条款

签署链接：https://cds-beta.climate.copernicus.eu/
初次登录账号后，将会看到：

根据提示，填写相关信息，更新使用条款。

2.3 更新.cdsapi文件

链接：https://cds-beta.climate.copernicus.eu/how-to-api

将红色方框中的内容复制到原有的.cdsapi文件中，.cdsapi文件的通常路径为：C:\\Users\\user_name目录下,其中user_name为自己设备的用户名。

更加详细的使用方法，请参考：https://confluence.ecmwf.int/display/CKB/How+to+install+and+use+CDS+API+on+Windows

3. 常见问题与解决方法（持续更新中）

3.1 问题1：更新完.cdsapi文件之后，原有下载代码不可以使用

解决方法：原有下载ERA5数据的脚本在CDS-Beta中已经不再适用，需要使用新的网站，获取新的数据下载命令，进而进行下载。
CDS-Beta数据下载网址：https://cds-beta.climate.copernicus.eu/datasets

数据筛选过程与原有方式类似，只是下载的代码发生了变化，新的代码例子展示：

import cdsapi

dataset = "reanalysis-era5-single-levels-monthly-means"
request = {
    'product_type': ['monthly_averaged_reanalysis'],
    'variable': ['10m_u_component_of_wind'],
    'year': ['1940'],
    'month': ['01'],
    'time': ['00:00'],
    'data_format': 'netcdf',
    'download_format': 'unarchived'
}

client = cdsapi.Client()
client.retrieve(dataset, request).download()

3.2 问题2: RuntimeError: 403 Client Error: required licences not accepted

第一次使用CDS-Beta的时候，会出现:

RuntimeError: 403 Client Error: required licences not accepted
required licences not accepted; please accept the following licences to proceed: {'id': 'licence-to-use-copernicus-products', 'revision': 12}

的错误。
解决方法：按照3.1问题1的步骤，同意相关条款即可

3.3 问题3：.cdsapi报错

解决方法：.cdsapi文件中url:和key:的两个冒号：后面，不要有空格。

参考内容：

1. ERA5数据官网下载之CDS-Beta升级方法和避坑指南！
   
2. https://forum.ecmwf.int/t/the-new-climate-data-store-beta-cds-beta-is-now-live/3315/5