{"id":26129508,"url":"https://github.com/mathworks-ref-arch/matlab-aws-athena","last_synced_at":"2025-04-13T18:42:40.832Z","repository":{"id":78586825,"uuid":"196176299","full_name":"mathworks-ref-arch/matlab-aws-athena","owner":"mathworks-ref-arch","description":"MATLAB Interface for AWS Athena","archived":false,"fork":false,"pushed_at":"2023-10-04T21:47:17.000Z","size":46,"stargazers_count":3,"open_issues_count":0,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-10T19:55:15.744Z","etag":null,"topics":["matlab-aws"],"latest_commit_sha":null,"homepage":"","language":"MATLAB","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mathworks-ref-arch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-10T09:31:59.000Z","updated_at":"2024-11-13T09:02:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"2f21ff8e-f2c5-4b33-ade2-cbca3355bb90","html_url":"https://github.com/mathworks-ref-arch/matlab-aws-athena","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-athena","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-athena/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-athena/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mathworks-ref-arch%2Fmatlab-aws-athena/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mathworks-ref-arch","download_url":"https://codeload.github.com/mathworks-ref-arch/matlab-aws-athena/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248764972,"owners_count":21158195,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["matlab-aws"],"created_at":"2025-03-10T19:49:13.513Z","updated_at":"2025-04-13T18:42:40.799Z","avatar_url":"https://github.com/mathworks-ref-arch.png","language":"MATLAB","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n#  MATLAB Interface *for AWS Athena*\nMATLAB® Interface for Amazon Web Services Athena™ Service.\nAmazon Athena is an interactive query service that makes it easy to analyze data in Amazon S3 using standard SQL. Athena is serverless, so there is no infrastructure to manage, and you pay only for the queries that you run. This package provides a basic interface to a subset of Athena features\nfrom within MATLAB.\n\n## Requirements\n### MathWorks products\n* Requires MATLAB release R2017b or later.\n* AWS Common utilities found at https://github.com/mathworks-ref-arch/matlab-aws-common\n\n### 3rd party products\n* Amazon Web Services account   \n\nTo build a required JAR file:   \n* [Maven](https://maven.apache.org/)\n* JDK 8+\n\n## Getting Started\nPlease refer to the [Documentation](Documentation/README.md) to get started.\nThe [Installation Instructions](Documentation/Installation.md) and [Basic Usage](Documentation/BasicUsage.md) documents provide detailed instructions on setting up and using the interface. The easiest way to\nfetch this repository and all required dependencies is to clone the top-level repository using:\n\n```bash\ngit clone --recursive https://github.com/mathworks-ref-arch/mathworks-aws-support.git\n```\n\n### Build the AWS SDK for Java components\nThe MATLAB code uses the AWS SDK for Java and can be built using:\n```bash\ncd matlab-aws-athena/Software/Java\nmvn clean package\n```\n\nOnce built, use the ```matlab-aws-athena/Software/MATLAB/startup.m``` function to initialize the interface which will use the AWS Credentials Provider Chain to authenticate. Please see the [relevant documentation](Documentation/Authentication.md) on how to specify the credentials.\n\n### Using the interface\n\n\n```matlab\n% Create some data needed in the examples\ndbName = 'MyAirlines.airlines';\nresultBucket = 's3://testing/airlineresult';\ndistLimit = 1000;\n\n% Create the client object and authenticate using \n%   the AWS Default Provider Chain\nath = aws.athena.AthenaClient();\nath.Database = dbName;\nath.initialize\n\n\n% Create a SQL statement and execute it (asynchronously)\nqueryFar = sprintf('SELECT UniqueCarrier, distance FROM %s WHERE distance \u003e %d;', ...\n    dbName, distLimit);\nresultIDFar = ath.submitQuery(queryFar, resultBucket);\n\n% Check the status, and make sure it says 'SUCCEEDED'\nstatus = char(ath.getStatusOfQuery(resultIDFar));\n\n% At this point, we can read the results by using a MATLAB datastore\nresFile = sprintf('%s/%s.csv', resultBucket, char(resultIDFar));\nds = datastore(resFile);\nds.NumHeaderLines = 1;\nfarResult = ds.readall();\n\n```\n\n## Supported Products:\n1. [MATLAB](https://www.mathworks.com/products/matlab.html) (R2017b or later)\n2. [MATLAB Compiler™](https://www.mathworks.com/products/compiler.html) and [MATLAB Compiler SDK™](https://www.mathworks.com/products/matlab-compiler-sdk.html) (R2017b or later)\n3. [MATLAB Production Server™](https://www.mathworks.com/products/matlab-production-server.html) (R2017b or later)\n4. [MATLAB Parallel Server™](https://www.mathworks.com/products/distriben.html) (R2017b or later)\n\n## License\nThe license for the MATLAB Interface *for AWS Athena* is available in the [LICENSE.md](LICENSE.md) file in this GitHub repository. This package uses certain third-party content which is licensed under separate license agreements. See the [pom.xml](Software/Java/pom.xml) file for third-party software downloaded at build time.\n\n## Enhancement Request\nProvide suggestions for additional features or capabilities using the following link:   \nhttps://www.mathworks.com/products/reference-architectures/request-new-reference-architectures.html\n\n## Support\nEmail: `mwlab@mathworks.com`    \n\n[//]: #  (Copyright 2019 The MathWorks, Inc.)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-athena","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-athena","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmathworks-ref-arch%2Fmatlab-aws-athena/lists"}