魔法のコマンド
Keep, per Jack, even though command descriptions are in the notebook. In the notebook, the general commands and AI Unlimited commands are all together. So it's good for users to see a list of AI-Unlimited-specific ones. The kernel is in dev. Need to update this topic.
AI Unlimited JupyterLab supports these magic commands in addition to the existing Teradata SQL Kernel magic commands. See Teradata JupyterLab Getting Started Guide. Probably don't want to refer to that kernel, wrong product.
%workspaces_config
Description: One-time configuration to bind with the workspace service.
Usage:
Where:
-
host: Name or IP address of the engine service.
-
apikey: API Key value from the workspace service Profile page.
-
[Optional]
withTLS: If False (F), the default client-server communication does not use TLS.
Output:
%project_create
Description: Create a new project. This command also creates a new repository with the project name in your GitHub account. The configurations are stored in the engine.yml file.
Usage:
Where:
-
project: Name of the project to be created.
-
env: Cloud environment where the project is hosted. The value can be aws, azure, gcp, or vsphere. For the current release, AWS and Azure are supported.
-
[Optional]
team: Name of the team collaborating on the project.
Output:
%project_delete
Description: Delete a project.
Running this command removes the GitHub repository containing the objects created using Teradata AI Unlimited.
Usage:
Where:
-
project: Name of the project to be deleted.
-
[Optional]
team: Name of the team collaborating on the project.
Output:
Project `Project_Name` deleted
%project_list
Description: List the details of the projects.
Use the project parameter to get the details of a specific project. All the projects are listed if you run the command without any parameters.
Usage:
Where:
- project: Name of the project to be listed.
Output:
%project_auth_create
Description: Create an authorization object to store object store credentials.
You must create the authorization object before deploying the engine. The authorization details are retained and are included while redeploying the project. Optionally, you can create authorizations manually using the CREATE AUTHORIZATION
SQL command after deploying the engine. In this case, the authorization details are not retained.
Usage:
Where:
-
project: Name of the project.
-
name: Authorization name for the object store.
-
key: Authorization key of the object store.
-
secret: Authorization secret access ID of the object store.
-
region: Region of the object store; local for the local object store.
-
[Optional]
token: Session token for the object store access. -
[Optional]
role: IAM users or service account to access AWS resources from an AWS account by assuming a role and its entitlements. The owner of the AWS resource defines the role. For example: arn:aws:iam::00000:role/STSAssumeRole. -
ExternalID: External ID used to access object store.
Output:
%project_auth_update
Description: Update an object store authorization.
Usage:
Where:
- project: Name of the project.
- name: Authorization name for the object store.
- key: Authorization key of the object store.
[Optional]
secret: Authorization secret access ID of the object store.- **
[Optional]
**region: Region of the object store; local for the local object store. [Optional]
token: Session token for the object store access.[Optional]
role: IAM users or service account to access AWS resources from an AWS account by assuming a role and its entitlements. The owner of the AWS resource defines the role. For example: arn:aws:iam::00000:role/STSAssumeRole.- ExternalID: External ID used to access object store.
Output:
%project_auth_delete
Description: Remove an object store authorization.
Usage:
Where:
- project: Name of the project.
- name: Authorization name for the object store.
Output:
%project_auth_list
Description: List object store authorizations that are created for a project.
Usage:
Where:
- project: Name of the project.
Output:
Insert Code Snippet
%project_engine_deploy
Description: Deploy an engine for the project. The deployment process takes a few minutes to complete. On successful deployment, a password is generated.
Usage:
Where:
-
project: Name of the project.
-
size: Size of the engine. The value can be:
- small
- medium
- large
- extralarge
-
[Optional]
node: Number of engine nodes to be deployed. The default value is 1. -
[Optional]
subnet: Subnet used for the engine if there are no default values from the service. -
[Optional]
region: Region used for the engine if there are no default values from service. -
[Optional]
secgroups: List of security groups for the VPC in each region. If you don't specify a security group, the engine is automatically associated with the default security group for the VPC. -
[Optional]
cidr: List of CIDR addresses used for the engine.
Output:
%project_engine_suspend
Description: Stop the engine after you're done with your work.
Usage:
Where:
- project: Name of the project.
Output:
%project_engine_list
Description: View the list of engines deployed for your project.
Usage:
Where:
- project: Name of the project.
Output:
Insert Code Snippet
%project_user_list
Description: View the list of collaborators assigned to the project.
Usage:
Where:
*[Optional]*
project: Name of the project.
Output:
Insert Code Snippet
%project_backup
Description: Back up your project metadata and object definition inside the engine.
Usage:
Where:
- project: Name of the project.
Output:
%project_restore
Description: Restore your project metadata and object definition from your GitHub or GitLab repository.
Usage:
Where:
- project: Name of the project.
*[Optional]*
gitref: Git reference.
Output:
%help
Description: View the list of magics provided with AI-Unlimited-Teradata SQL CE Kernel.
Usage:
Additionally, you can see detailed help messages per command.
Usage: